edfest-mcp

🚀 edfringe - mcp

edfringe - mcp 是一个 MCP 服务器，可用于查询爱丁堡艺术节 API，获取所有爱丁堡艺术节的活动和场馆信息，包括历史数据。

请注意，目前暂不支持访问 2025 年边缘艺术节的活动数据，这需要获得批准。

✨ 主要特性

• search_edinburgh_festivals：可根据地点、类型、日期或文本搜索活动。
• search_edinburgh_festival_venues：可根据艺术节类型、邮政编码或其他标准搜索场馆。

📦 安装指南

环境要求

• Python 3.12 及以上版本
• uv

安装步骤

1. 创建爱丁堡艺术节 API 账户。
2. 克隆或下载本项目。在项目根目录下创建一个 .env 文件，内容如下：

api_secret=your_secret
api_key=your_key

3. 安装依赖项：

uv sync

4. 在你的 LLM 客户端应用的 mcp.json 配置文件中添加以下 MCP 配置：

"edinburghFestival": {
    "command": "uv",
    "args": [
        "--directory",
        "/full/path/to/edfringe - mcp",
        "run",
        "main.py"
    ]
}

📚 详细文档

开发

运行测试：

uv sync --all - groups
uv run pytest

📄 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE。