Shortcut.com MCP Server

基本能力

产品定位

mcp-server-shortcut 是一个用于与 Shortcut.com 工单管理系统交互的 MCP 服务，旨在通过 AI 助手提升工单管理的效率。

核心功能

• 列出和搜索 Shortcut 中的工单
• 获取特定工单的详细信息
• 创建新工单
• 更新现有工单
• 添加评论到工单
• 检索工作流状态和项目

适用场景

• 团队协作中的工单管理
• AI 助手辅助的工单处理
• 自动化工单创建和更新

工具列表

• list_stories: 列出工单，支持过滤
• search_stories: 使用文本查询搜索工单
• get_story_details: 获取特定工单的详细信息
• create_story: 创建新工单
• update_story: 更新现有工单
• add_comment: 添加评论到工单
• list_workflow_states: 列出所有工作流状态
• list_projects: 列出所有项目

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

• Python 3.10+
• Shortcut.com API token

安装教程

1. 克隆仓库: bash git clone https://github.com/yourusername/mcp-server-shortcut.git cd mcp-server-shortcut

2. 创建虚拟环境并安装依赖: ```bash # 使用 uv (推荐) curl -LsSf https://astral.sh/uv/install.sh | sh # For Mac/Linux uv venv source .venv/bin/activate # On Mac/Linux or .venv\Scripts\activate on Windows uv pip install -r requirements.txt

# 使用 pip python -m venv venv source venv/bin/activate # On Mac/Linux or venv\Scripts\activate on Windows pip install -r requirements.txt ```

1. 创建 .env 文件: 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:

1. 编辑 Claude Desktop 配置文件
2. 添加 MCP 服务器配置
3. 重启 Claude Desktop

许可证

该项目遵循 MIT 开源许可条款。