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

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

Shortcut (旧 Clubhouse) と対話するための Model Context Protocol (MCP) サーバー。

特徴

プロジェクト、ストーリー、エピック、目標を表示する
ストーリーを検索する
新しいストーリー、叙事詩、目標を作成する
安全な操作のみ（更新や削除は不可）

Related MCP server: Shortcut.com MCP Server

設定

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

F

license - not found

-

quality - not tested

-

maintenance - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Shortcut MCP Server