Pylon MCP服务器

Pylon MCP服务器是一个用于与Pylon API集成的模型上下文协议服务器,提供管理账户、问题、消息和自定义字段的工具。

  • by gasconc
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 gasconc/pylon-mcp-server

使用说明

塔式MCP服务器

用于与Pylon API集成的MCP(模型上下文协议)服务器。此服务器提供用于管理Pylon中的帐户、问题、消息和自定义字段的工具。

特性

  • 账户:列出、获取、创建和更新帐户
  • 问题:使用高级筛选器列出、获取、创建、更新和搜索支持问题
  • 消息:获取问题消息并编辑消息
  • 自定义字段:列出、获取、创建和更新自定义字段

先决条件

  • Node.js 18或更高版本
  • 具有API访问权限的Pylon帐户
  • Pylon API令牌

安装

  1. 克隆或导航到项目目录:
cd pylon-mcp-server
  1. 安装依赖项:
npm install
  1. 设置环境变量:
cp env.example .env
  1. 编辑 .env 并添加您的Pylon API令牌:
PYLON_API_TOKEN=your_pylon_api_token_here

光标中的配置

将以下内容添加到光标MCP设置文件中(~/.cursor/mcp.json 或项目的 .cursor/mcp.json):

{
  "mcpServers": {
    "pylon": {
      "command": "node",
      "args": ["/path/to/pylon-mcp-server/src/index.js"],
      "env": {
        "PYLON_API_TOKEN": "your_pylon_api_token_here"
      }
    }
  }
}

替换 /path/to/pylon-mcp-server 与这个项目的实际路径。

可用工具

账户

工具 说明
pylon_list_accounts 列出所有具有可选分页的帐户
pylon_get_account 按ID获取特定帐户
pylon_create_account 创建新帐户
pylon_update_account 更新现有帐户

问题

工具 说明
pylon_list_issues 列出时间范围内的问题
pylon_get_issue 按ID获取特定问题
pylon_create_issue 创建新问题
pylon_update_issue 更新现有问题
pylon_search_issues 使用高级过滤器(状态、优先级、受让人、标签等)搜索问题

消息

工具 说明
pylon_get_issue_messages 获取特定问题的所有消息
pylon_redact_message 修改问题中的特定消息

自定义字段

工具 说明
pylon_list_custom_fields 按对象类型(帐户、问题、联系人)列出自定义字段
pylon_get_custom_field 按ID获取特定的自定义字段
pylon_create_custom_field 创建新的自定义字段
pylon_update_custom_field 更新现有自定义字段

使用示例

列出帐户

List all accounts in Pylon

获取上周的问题

List all issues from the last 7 days

创建一个新账户

Create a new account named "Acme Corp" with domain "acme.com"

搜索未解决的高优先级问题

Search for all open issues with high or urgent priority

这 pylon_search_issues 该工具支持使用AND/OR运算符的复杂过滤器:

{
  "filter": {
    "operator": "and",
    "subfilters": [
      { "field": "state", "operator": "equals", "value": "open" },
      { "field": "priority", "operator": "in", "values": ["high", "urgent"] }
    ]
  },
  "limit": 50
}

可用筛选字段: state, priority, assignee.id, account.id, tags, requester.email, source, team.id

创建自定义字段

Create a select custom field called "Priority Level" for issues with options: Low, Medium, High

API 参考

有关Pylon API的更多信息,请参阅:

发展

在开发模式下运行并自动重新加载:

npm run dev

许可证

麻省理工学院