Shortcut.com MCP サーバー

Shortcut.com 上のチケットにアクセスして検索するための Model Context Protocol (MCP) サーバーの実装。

概要

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

• ショートカットでストーリー（チケット）を一覧表示および検索する

• 特定のストーリーに関する詳細情報を取得する

• 新しい物語を創る

• 既存のストーリーを更新する

• ストーリーにコメントを追加する

• ワークフローの状態とプロジェクトを取得する

Related MCP server: Shortcut MCP Server

前提条件

• 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. ショートカット API トークンを使用して、プロジェクト ルート ディレクトリに.envファイルを作成します。

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

サーバーの実行

次を使用して MCP サーバーを起動します。

python -m src.server

Claudeデスクトップの設定

この 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 - ショートカット API のクライアント

  • utils.py - ユーティリティ関数とデータモデル

• requirements.txt - プロジェクトの依存関係

• .env - 環境変数（git では追跡されません）

発達

新しい機能の追加

MCP サーバーに新しい機能を追加するには:

1. 新しい API メソッドをshortcut_client.pyに追加します。

2. 必要に応じてutils.pyで Pydantic モデルを定義します。

3. server.pyのデコレータを使用して MCP 機能を実装します。

   • 読み取り専用リソースには@mcp.resource()を使用します

   • データを変更できるアクションには@mcp.tool()を使用します

   • テンプレートまたは構造化テキストを生成するには@mcp.prompt()を使用します

貢献

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

ライセンス

MITライセンス

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers