remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools for interacting with Shortcut (formerly Clubhouse) to view and manage projects, stories, epics, and objectives, including capabilities for searching through stories and creating new items.

快捷方式 MCP 服务器

[!WARNING] 这是一个 WIP 服务器，可能无法按预期工作。

用于与 Shortcut（以前称为 Clubhouse）交互的模型上下文协议 (MCP) 服务器。

特征

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

设置

使用 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中。

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

一个模型上下文协议服务器，可以与 Shortcut（以前称为 Clubhouse）项目管理工具进行交互，允许用户查看和搜索项目、故事、史诗和目标，以及通过自然语言创建新项目。

Related Resources

Reddit Discussion about this server

Shortcut MCP Server