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

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 Snapshot Server
crazyrabbitLTC
A
security
A
license
A
quality
A Model Context Protocol server that enables interaction with Snapshot.org, providing tools to query Snapshot spaces, proposals, and users through natural language.
Last updated -
5
2
TypeScript
MIT License
Workato MCP Server
jacobgoren-sb
-
security
A
license
-
quality
A Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.
Last updated -
TypeScript
MIT License
Loveable.dev MCP Server
iamseancorcoran
-
security
A
license
-
quality
A Model Context Protocol server that enables users to create, check status, and get details of projects on Loveable.dev, a platform for quickly creating applications.
Last updated -
JavaScript
ISC License
Foundry MCP Project
lhemerly
-
security
A
license
-
quality
A Model Context Protocol server that enables interaction with Foundry tools through natural language, allowing users to create projects, build contracts, run tests, and manage Ethereum development environments.
Last updated -
1
Python
MIT License

View all related MCP servers

Shortcut MCP Server