爱丁堡节日数据查询服务

edfringe mcp

MCP服务器，用于查询爱丁堡节日API，以获取所有爱丁堡节日的活动和场地信息，包括历史数据。

请注意，仅在请求时才支持访问2025年的Fringe活动数据。远程运行此MCP需要爱丁堡艺穗节的批准。

工具

• search_edinburgh_festivals：根据地点、类型、日期或文本搜索事件。
• search_edinburgh_festival_venues：根据节日类型、邮政编码或其他条件搜索场地。

一些提示也可用于构建具有正确上下文的查询。

查询示例

• 镀金气球今晚有什么节目？->这些是喜剧吗？
• 会议室有哪些残疾人通道？
• 戈登·布朗上次在图书节上讲话是什么时候？

如果您添加了谷歌地图密钥，则也支持路线和导航，或者安装谷歌地图MCP）

• 在镀金气球和欢乐之间走多久？

需求

• Python 3.12+
• 紫外线

设置

1. 创建爱丁堡艺术节API帐户.

2. 克隆或下载此项目。
   创建一个 .env 项目根目录中的文件包含：

   复制

   api_secret=your_secret
   api_key=your_key
   

   如果你有一个谷歌地图API密钥，你可以添加

   复制

   GOOGLE_MAPS_API_KEY=your API key
   

   这将实现场馆之间的计时和路线计算。

3. 安装依赖项：

   复制

   uv sync
   

4. 将以下MCP配置添加到您的 mcp.json LLM客户端应用程序中的配置文件：

   复制

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

发展

运行测试：

uv sync --all-groups
uv run pytest

许可证

该项目根据MIT许可证获得许可。看 许可证 了解详情。