mcp-live-events

🚀 MCP 实时活动服务器

mcp-live-events 是一个模型上下文协议 (MCP) 服务器，它与 Ticketmaster API 集成，能够为 AI 代理动态提供音乐会和活动的详细实时数据，解决了 AI 代理获取活动信息的难题，为其提供了便捷、实时的数据支持。

🚀 快速开始

mcp-live-events 服务器可帮助 AI 代理动态获取音乐会和活动的详细信息。按照以下步骤操作，即可快速搭建并运行该服务器。

✨ 主要特性

• 🎟️ 与 Ticketmaster API 集成，可用于搜索各类活动。
• 🗣️ 对 API 响应进行格式化处理，便于大语言模型（LLM）进行解释。

📦 安装指南

先决条件

确保系统中已安装以下软件和工具：

• uv（用于包管理）
• Python 3.13 及以上版本
• 一个 Ticketmaster API 密钥（可免费使用，但会受到速率限制）

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/mmmaaatttttt/mcp-live-events.git
   cd mcp-live-events
   

2. 安装项目依赖项：

   uv venv
   uv sync
   

3. 设置环境变量，例如 Ticketmaster API 密钥。您可以将其放在项目仓库中的 .env 文件中，文件格式可参考 .env.example；或者将其放在 MCP 客户端此服务器配置的“env”部分。

⚠️ 重要提示

在 Ticketmaster 开发者控制台中，API 密钥名为“消费者密钥”。

运行服务器

使用以下命令启动服务器：

uv run mcp-live-events

若服务器成功启动，您将在终端看到 MCP 实时活动服务器正在运行！ 的提示信息。

📚 详细文档

• 介绍模型上下文协议
• 模型上下文协议文档
• MCP 服务器演示快速入门