ショートカット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にあります。