ショートカットMCPサーバー

[!警告] これは WIP サーバーであり、意図したとおりに動作しない可能性があります。

Shortcut (旧 Clubhouse) と対話するための Model Context Protocol (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 Inspector を使用してサーバーをテストできます。

npx @modelcontextprotocol/inspector python -m shortcut_mcp

安全機能

このサーバーは、安全な作成機能を備えた読み取り専用操作を実装します。

GET（読み取り）とPOST（作成）操作のみを許可します
既存データの変更や削除は行いません
すべての操作はAPIトークンの所有者に帰属します

発達

Python バージョン管理

このプロジェクトでは、Pythonのバージョン管理にasdfを使用しています。必要な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