快捷方式 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_mcppylint 的配置位于.pylintrc中。
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.