Shortcut.com MCP サーバー

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

概要

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

このリポジトリをクローンします:
git clone https://github.com/yourusername/mcp-server-shortcut.git cd mcp-server-shortcut
仮想環境を作成し、依存関係をインストールします。
# 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
ショートカット 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

この MCP サーバーを Claude Desktop で使用するには:

Claude Desktop 構成ファイルを編集します。
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
MCP サーバー構成を追加します。
{ "mcpServers": { "shortcut": { "command": "python", "args": ["-m", "src.server"], "env": { "SHORTCUT_API_TOKEN": "your_token_here" } } } }
Claude Desktop を再起動します。

src/ - ソースコードディレクトリ
- server.py - メイン MCP サーバーの実装
- config.py - 構成管理
- shortcut_client.py - ショートカット API のクライアント
- utils.py - ユーティリティ関数とデータモデル
requirements.txt - プロジェクトの依存関係
.env - 環境変数（git では追跡されません）

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

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