MCP Server Shortcut

🚀 Shortcut.com MCP サーバー

このプロジェクトは、Shortcut.com のモデルコンテキストプロトコル（MCP）サーバーを実装しており、Shortcut.com のチケットにアクセスし検索するために使用されます。

🚀 クイックスタート

このセクションでは、Shortcut.com MCP サーバーのセットアップとClaude Desktop との統合方法について説明します。

✨ 主な機能

このプロジェクトで実装されたMCP サーバーを通じて、Claude やその他の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. 仮想環境を作成し、依存関係をインストールします。

   # uv を使用する場合（推奨）
   curl -LsSf https://astral.sh/uv/install.sh | sh  # Mac/Linux
   uv venv
   source .venv/bin/activate  # Mac/Linux の場合 または .venv\Scripts\activate （Windows）
   uv pip install -r requirements.txt
   
   # pip を使用する場合
   python -m venv venv
   source venv/bin/activate  # Mac/Linux の場合 または venv\Scripts\activate （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 サーバーを起動します。

python -m src.server

高度な使用法

Claude Desktop と統合するために、Claude Desktop の設定ファイルにMCP サーバーの設定を追加します。

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

📚 ドキュメント

利用可能な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 - 環境変数のファイル

🔧 技術詳細

このプロジェクトは、Shortcut.com のモデルコンテキストプロトコル（MCP）サーバーを実装しています。Python を使用して開発されており、Shortcut API を通じてShortcut.com のチケット管理システムとやり取りします。Claude やその他のMCP 互換のAI アシスタントは、このサーバーを通じてShortcut のストーリーを操作することができます。

📄 ライセンス

[ここにライセンスを指定します。例：MIT またはApache]

🔗 コンタクト

• メール：[your.email@example.com]
• GitHub：@yourusername

このドキュメントでは、Shortcut.com のMCP サーバーのセットアップと実行方法、およびClaude Desktop との統合方法について説明しています。