快捷方式 MCP 服务器
WARNING
这是一个 WIP 服务器，可能无法按预期工作。
用于与 Shortcut（以前称为 Clubhouse）交互的模型上下文协议 (MCP) 服务器。
特征
查看项目、故事、史诗和目标
搜索故事
创建新的故事、史诗和目标
仅限安全操作（无更新或删除）
Related MCP server: Shortcut.com MCP Server
设置
使用 asdf 安装 Python：
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
项目结构
shortcut-mcp/
├── src/
│ └── shortcut_mcp/ # Main package directory
│ ├── __init__.py # Package initialization
│ ├── __main__.py # Entry point
│ └── server.py # Server implementation
├── pyproject.toml # Project configuration
├── .tool-versions # ASDF version configuration
├── .pylintrc # Pylint configuration
└── README.md
与 Claude Desktop 一起使用
将其添加到您的 Claude Desktop 配置中：
在 MacOS 上（ ~/Library/Application Support/Claude/claude_desktop_config.json ）：
{
"mcpServers": {
"shortcut": {
"command": "python",
"args": ["-m", "shortcut_mcp"],
"env": {
"SHORTCUT_API_TOKEN": "your_token_here"
}
}
}
}
在 Windows 上（ %AppData%\Claude\claude_desktop_config.json ）：
{
"mcpServers": {
"shortcut": {
"command": "python",
"args": ["-m", "shortcut_mcp"],
"env": {
"SHORTCUT_API_TOKEN": "your_token_here"
}
}
}
}
测试
您可以使用 MCP 检查器测试服务器：
npx @modelcontextprotocol/inspector python -m shortcut_mcp
安全功能
该服务器实现了具有安全创建功能的只读操作：
仅允许 GET（读取）和 POST（创建）操作
不修改或删除现有数据
所有操作均归属于 API 令牌所有者
发展
Python版本管理
该项目使用asdf进行 Python 版本管理。所需的 Python 版本在.tool-versions中指定。
# Install Python with asdf
asdf install python
# The correct version will be automatically selected based on .tool-versions
代码质量
我们使用 pylint 进行代码质量检查。运行以下命令：
pylint src/shortcut_mcp
pylint 的配置位于.pylintrc中。