ショートカットMCPサーバー

[!警告] これは WIP サーバーであり、意図したとおりに動作しない可能性があります。

Shortcut (旧 Clubhouse) と対話するための Model Context Protocol (MCP) サーバー。

特徴

プロジェクト、ストーリー、エピック、目標を表示する
ストーリーを検索する
新しいストーリー、叙事詩、目標を作成する
安全な操作のみ（更新や削除は不可）

設定

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にあります。

This server cannot be installed

security - not tested

license - not found

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Shortcut (旧 Clubhouse) プロジェクト管理ツールとのやり取りを可能にするモデルコンテキストプロトコルサーバー。これにより、ユーザーはプロジェクト、ストーリー、エピック、目標を表示および検索したり、自然言語で新しいアイテムを作成したりできます。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Snapshot Server
crazyrabbitLTC
A
security
A
license
A
quality
A Model Context Protocol server that enables interaction with Snapshot.org, providing tools to query Snapshot spaces, proposals, and users through natural language.
Last updated -
5
2
TypeScript
MIT License
Workato MCP Server
jacobgoren-sb
-
security
A
license
-
quality
A Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.
Last updated -
TypeScript
MIT License
Loveable.dev MCP Server
iamseancorcoran
-
security
A
license
-
quality
A Model Context Protocol server that enables users to create, check status, and get details of projects on Loveable.dev, a platform for quickly creating applications.
Last updated -
JavaScript
ISC License
Foundry MCP Project
lhemerly
-
security
A
license
-
quality
A Model Context Protocol server that enables interaction with Foundry tools through natural language, allowing users to create projects, build contracts, run tests, and manage Ethereum development environments.
Last updated -
1
Python
MIT License

View all related MCP servers

Shortcut MCP Server