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サーバー

[!警告] これは 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

F

license - not found

-

quality - not tested

Shortcut (旧 Clubhouse) プロジェクト管理ツールとのやり取りを可能にするモデルコンテキストプロトコルサーバー。これにより、ユーザーはプロジェクト、ストーリー、エピック、目標を表示および検索したり、自然言語で新しいアイテムを作成したりできます。

Related Resources

Reddit Discussion about this server

Shortcut MCP Server