
Shortcut MCP Server

2024.12.20
3
Python项目管理任务跟踪交流协作
Shortcut MCP Server 是一个用于与 Shortcut(原 Clubhouse)交互的 Model Context Protocol (MCP) 服务器。它提供了查看项目、故事、史诗和目标的功能,支持搜索故事,并能安全地创建新的故事、史诗和目标。该服务器仅支持读取和创建操作,不提供修改或删除功能,确保数据的安全性。
View on GitHub
Overview
基本能力
产品定位
Shortcut MCP Server 是一个用于与 Shortcut(项目管理工具)交互的 MCP 服务器,主要用于项目管理和任务跟踪。
核心功能
- 查看项目、故事、史诗和目标
- 搜索故事
- 创建新的故事、史诗和目标
- 仅支持安全操作(无更新或删除功能)
适用场景
- 项目管理
- 任务跟踪
- 团队协作
工具列表
- MCP Inspector:用于测试服务器的工具,可以通过命令行运行。
常见问题解答
- 该服务器目前处于开发中(WIP),可能无法按预期工作。
- 所有操作均归因于 API 令牌所有者,确保数据安全。
使用教程
使用依赖
- 安装 Python 和 asdf:
asdf install
- 创建虚拟环境并安装依赖:
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e . # Install package in editable mode
- 设置环境变量:
cp .env.example .env
# Edit .env and add your Shortcut API token
安装教程
- 运行服务器:
python -m shortcut_mcp
- 在 Claude Desktop 配置中添加服务器信息(MacOS 和 Windows 路径不同)。
调试方式
- 使用 MCP Inspector 测试服务器:
npx @modelcontextprotocol/inspector python -m shortcut_mcp
- 运行代码质量检查:
pylint src/shortcut_mcp
许可证
None