Shortcut MCP 服务器

[!警告] 这是一个正在进行中的服务器，可能无法按预期工作。

与Shortcut（原名Clubhouse）交互的模型上下文协议（MCP）服务器。

功能

• 查看项目、故事、史诗和目标
• 搜索故事
• 创建新的故事、史诗和目标
• 只执行安全操作（无更新或删除）

安装

1. 使用asdf安装Python：

asdf install

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

uv venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
uv pip install -e .  # 以可编辑模式安装包

3. 设置您的环境：

cp .env.example .env
# 编辑.env文件，并添加您的Shortcut API令牌

4. 启动服务器：

python -m shortcut_mcp

项目结构

shortcut-mcp/
├── src/
│   └── shortcut_mcp/      # 主包目录
│       ├── __init__.py    # 包初始化
│       ├── __main__.py    # 入口点
│       └── server.py      # 服务器实现
├── pyproject.toml         # 项目配置
├── .tool-versions         # ASDF版本配置
├── .pylintrc              # Pylint配置
└── 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 Inspector测试服务器：

npx @modelcontextprotocol/inspector python -m shortcut_mcp

安全特性

此服务器实现了只读操作和安全创建能力：

• 只允许GET（读取）和POST（创建）操作
• 不修改或删除现有数据
• 所有操作都归属于API令牌所有者

开发

Python 版本管理

该项目使用 asdf 进行Python版本管理。所需的Python版本在.tool-versions文件中指定。

# 使用asdf安装Python
asdf install python

# 正确的版本将根据.tool-versions自动选择

代码质量

我们使用pylint进行代码质量检查。运行它：

pylint src/shortcut_mcp

pylint的配置在.pylintrc文件中。