Shortcut.com MCP Server

Shortcut.com MCP サーバー

Shortcut.com のチケットにアクセスし、検索するための Model Context Protocol（MCP）サーバーの実装です。

概要

このプロジェクトは、Claude やその他の MCP 対応 AI アシスタントが Shortcut.com のチケット管理システムと連携できるようにする MCP サーバーを実装しています。この連携により、AI アシスタントは次の操作を実行できます。

• Shortcut のストーリー（チケット）の一覧表示と検索
• 特定のストーリーの詳細情報の取得
• 新しいストーリーの作成
• 既存のストーリーの更新
• ストーリーへのコメントの追加
• ワークフローの状態とプロジェクトの取得

前提条件

• Python 3.10+
• Shortcut.com API トークン

インストール

1. このリポジトリをクローンします。

   git clone https://github.com/yourusername/mcp-server-shortcut.git
   cd mcp-server-shortcut
   

2. 仮想環境を作成し、依存関係をインストールします。

   # Using uv (recommended)
   curl -LsSf https://astral.sh/uv/install.sh | sh  # For Mac/Linux
   uv venv
   source .venv/bin/activate  # On Mac/Linux or .venv\Scripts\activate on Windows
   uv pip install -r requirements.txt
   
   # Using pip
   python -m venv venv
   source venv/bin/activate  # On Mac/Linux or venv\Scripts\activate on Windows
   pip install -r requirements.txt
   

3. プロジェクトのルートディレクトリに .env ファイルを作成し、Shortcut API トークンを記述します。

   SHORTCUT_API_TOKEN=your_token_here
   SERVER_PORT=5000
   SERVER_HOST=0.0.0.0
   DEBUG_MODE=True
   

サーバーの起動

次のコマンドで MCP サーバーを起動します。

python -m src.server

Claude Desktop の設定

この MCP サーバーを Claude Desktop で使用するには、次の手順に従います。

1. Claude Desktop の設定ファイルを編集します。

   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. MCP サーバーの設定を追加します。

   {
     "mcpServers": {
       "shortcut": {
         "command": "python",
         "args": ["-m", "src.server"],
         "env": {
           "SHORTCUT_API_TOKEN": "your_token_here"
         }
       }
     }
   }
   

3. Claude Desktop を再起動します。

利用可能な MCP 機能

リソース

• shortcut://stories - ストーリーの一覧にアクセスします
• shortcut://story/{story_id} - 特定のストーリーにアクセスします

ツール

• list_stories - 任意の条件で絞り込んでストーリーを一覧表示します
• search_stories - テキストクエリを使ってストーリーを検索します
• get_story_details - 特定のストーリーの詳細情報を取得します
• create_story - 新しいストーリーを作成します
• update_story - 既存のストーリーを更新します
• add_comment - ストーリーにコメントを追加します
• list_workflow_states - すべてのワークフロー状態を一覧表示します
• list_projects - すべてのプロジェクトを一覧表示します

プロンプト

• create_bug_report - バグレポートのテンプレートを生成します
• create_feature_request - 機能リクエストのテンプレートを生成します

プロジェクト構成

• src/ - ソースコードディレクトリ
  • server.py - MCP サーバーのメイン実装
  • config.py - 設定管理
  • shortcut_client.py - Shortcut API のクライアント
  • utils.py - ユーティリティ関数とデータモデル
• requirements.txt - プロジェクトの依存関係
• .env - 環境変数（git の追跡対象外）

開発

新しい機能の追加

MCP サーバーに新しい機能を追加するには、次の手順に従います。

1. shortcut_client.py に必要な API メソッドを追加します
2. 必要に応じて utils.py に Pydantic モデルを定義します
3. server.py のデコレーターを使って MCP 機能を実装します。
   • 読み取り専用のリソースには @mcp.resource() を使用します
   • データを変更するアクションには @mcp.tool() を使用します
   • テンプレートや構造化テキストの生成には @mcp.prompt() を使用します

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス