返回 MCP 目录
public公开dns本地运行

ticket_tailor_mcp_server

一个Python MCP封装的Ticket Tailor API集成工具,方便LLM与Ticket Tailor API交互,提供事件检索、订单查询等功能,支持开发者扩展API端点。

article

README

🚀 票务裁剪器API集成

这是一个基于Python的MCP包装器,用于与Ticket Tailor API进行交互。借助它,大型语言模型(LLM)能够轻松操作Ticket Tailor API。目前项目仍处于早期阶段,但基础工作已经完成。当下的工作重点是为各个端点构建功能,同时还能构建可执行数据处理工作的特定工具,而非仅仅进行数据的获取或提交。创建活动的代码将在其他地方编写,后续会引入到项目中。

🚀 快速开始

安装

# 克隆仓库
git clone https://github.com/shakermakerk/ticket_tailor_mcp_server.git
cd ticket_tailor_mcp_server

# 安装依赖项
pip install -r requirements.txt

设置

  1. 根据.env_example文件创建根目录中的.env文件,以添加Ticket Tailor API密钥

✨ 主要特性

  • 使用灵活的过滤选项检索事件
  • 使用全面的搜索参数获取订单
  • 基于FastMCP构建,便于集成到应用程序中

💻 使用示例

基础用法

与Cursor一起使用(通常我们不希望这样做): 编辑mcp.json文件,添加以下内容:

    "tt-events": {
      "type": "command",
      "command": "mcp 运行 /src/ticket_tailor/ticket_tailor_funcs.py" # 可能需要修改此路径
    }

高级用法

使用我们自己的代理。这取决于您使用的代理框架,通常会将MCP服务器作为工具传递。某些框架(例如Openai - Agents SDK)是异步的,可能需要一些辅助函数。如果需要请求示例,请查看ticket_tailor_mcp_server/src/ticket_tailor/example_langgraph_agent.py文件中使用langchain react agents(而不是langgraph)的简单示例。

📚 详细文档

API参考

请查看src/ticket_tailor目录以获取实现详细信息。

开发路线图

我们正在努力实现更多的Ticket Tailor API端点。有关优先级列表、当前实施状态和添加新端点的指南,请参阅路线图

如果需要贡献,可以查看路线图中未实现的端点,并遵循以下步骤:

  1. 检查路线图以获取待实现的端点
  2. 查看贡献指南以获取规范
  3. 创建一个问题来跟踪您的工作
  4. 提交一个拉取请求,附带您的实现

我们特别欢迎遵循现有代码中建立的模式实现新API端点的贡献。

贡献

欢迎贡献!以下是您可以帮助的方式:

  1. 检查路线图以获取待实现的端点
  2. 查看贡献指南以获取规范
  3. 创建一个问题来跟踪您的工作
  4. 提交一个拉取请求,附带您的实现

我们特别欢迎遵循现有代码中建立的模式实现新API端点的贡献。

📄 许可证

本项目使用MIT许可证 - 请查看LICENSE文件以获取详细信息。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端