快捷方式 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

license - not found

quality - not tested

How are these scores calculated?

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.

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
1
Python
MIT License
Shortcut.com MCP Server
WynnD
-
security
F
license
-
quality
An implementation of a Model Context Protocol server that allows Claude and other AI assistants to interact with Shortcut.com's ticket management system for searching, viewing, creating, and updating stories.
Last updated -
Python
Shortcut MCP Serverofficial
useshortcut
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that integrates Shortcut project management with AI tools like Cursor, Windsurf, and Claude Code, allowing direct access to Shortcut data via API token.
Last updated -
32
2,241
57
TypeScript
MIT License
Memory Bank MCP Server
nicavcrm
A
security
F
license
A
quality
A Model Context Protocol server that provides structured workflow tools for managing software development projects through different complexity levels, offering specialized modes for project planning, design, implementation, and documentation.
Last updated -
5
66
1
TypeScript

View all related MCP servers

Shortcut MCP Server