金大哥 - Shortcut MCP 详情

article

README

🚀 Shortcut.com MCP 服务器

本项目实现的模型上下文协议（MCP）服务器，可用于访问和搜索 Shortcut.com 票务系统。它能让 Claude 等支持 MCP 协议的人工智能助手与 Shortcut.com 票务管理系统进行交互，为票务管理带来便利。

🚀 快速开始

本项目实现了与 Claude 和其他支持 MCP 协议的人工智能助手交互的 MCP 服务器，允许这些 AI 助手与 Shortcut.com 的票务管理系统进行交互。借助此集成，AI 助手可执行以下操作：

列出和搜索 Shortcut 中的故事（票务）
获取特定故事的详细信息
创建新故事
更新现有故事
向故事添加评论
检索工作流状态和项目

✨ 主要特性

丰富的票务操作：支持对 Shortcut.com 票务系统中的故事进行列出、搜索、创建、更新、添加评论等操作。
便捷的集成方式：可与 Claude 等支持 MCP 协议的人工智能助手集成，实现自动化票务管理。
多样化的功能接口：提供了多种 MCP 功能，包括资源访问、工具调用和提示生成等。

📦 安装指南

先决条件

Python 3.10+
Shortcut.com API 令牌

安装步骤

克隆此仓库：

git clone https://github.com/yourusername/mcp-server-shortcut.git
cd mcp-server-shortcut

创建虚拟环境并安装依赖项：

# 使用uv（推荐）
curl -LsSf https://astral.sh/uv/install.sh | sh  # 对于Mac/Linux
uv venv
source .venv/bin/activate  # 在Mac/Linux上或.venv\Scripts\activate在Windows上
uv pip install -r requirements.txt

# 使用pip
python -m venv venv
source venv/bin/activate  # 在Mac/Linux上或 venv\Scripts\activate 在 Windows 上
pip install -r requirements.txt

在项目根目录中创建一个 .env 文件，添加您的 Shortcut API 令牌：

SHORTCUT_API_TOKEN=your_token_here
SERVER_PORT=5000
SERVER_HOST=0.0.0.0
DEBUG_MODE=True

💻 使用示例

运行服务器

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

python -m src.server

配置 Claude Desktop

要将此 MCP 服务器与 Claude Desktop 一起使用：

编辑 Claude Desktop 的配置文件：
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

添加 MCP 服务器配置：

{
  "mcpServers": {
    "shortcut": {
      "command": "python",
      "args": ["-m", "src.server"],
      "env": {
        "SHORTCUT_API_TOKEN": "your_token_here"
      }
    }
  }
}

重启 Claude Desktop。

📚 详细文档

可用的 MCP 功能

资源

shortcut://stories - 访问故事列表
shortcut://story/{story_id} - 访问特定的故事

工具

list_stories - 列出带可选过滤的故事
search_stories - 使用文本查询搜索故事
get_story_details - 获取特定故事的详细信息
create_story - 创建新故事
update_story - 更新现有故事
add_comment - 向故事添加评论
list_workflow_states - 列出所有工作流状态
list_projects - 列出所有项目

提示

create_bug_report - 生成错误报告模板
create_feature_request - 生成功能请求模板

项目结构

src/ - 源代码目录
- server.py - MCP 服务器的主文件
- client.py - 示例客户端代码，用于与 MCP 服务器交互
- config.py - 配置设置和环境变量
- requirements.txt - 项目所需的 Python 依赖项

开发

要向此项目添加新功能，请按照以下步骤操作：

克隆仓库并在本地环境中安装依赖项。
修改代码以添加所需的功能。
测试更改，确保所有现有功能继续正常工作。
提交更改并创建一个拉取请求。

贡献

我们欢迎社区的贡献！如果您发现任何问题或有任何改进建议，请提交问题或拉取请求。请参考我们的贡献指南了解如何参与。

📄 许可证

此项目受MIT License许可保护。

Shortcut