塔式MCP服务器
用于与Pylon API集成的MCP(模型上下文协议)服务器。此服务器提供用于管理Pylon中的帐户、问题、消息和自定义字段的工具。
特性
- 账户:列出、获取、创建和更新帐户
- 问题:使用高级筛选器列出、获取、创建、更新和搜索支持问题
- 消息:获取问题消息并编辑消息
- 自定义字段:列出、获取、创建和更新自定义字段
先决条件
- Node.js 18或更高版本
- 具有API访问权限的Pylon帐户
- Pylon API令牌
安装
- 克隆或导航到项目目录:
cd pylon-mcp-server- 安装依赖项:
npm install- 设置环境变量:
cp env.example .env- 编辑
.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, HighAPI 参考
有关Pylon API的更多信息,请参阅:
发展
在开发模式下运行并自动重新加载:
npm run dev许可证
麻省理工学院
