Capacities Mcp Plus

Capacities MCP Plus

Capacities 用の拡張 MCP（Model Context Protocol）サーバーです。ナレッジ管理システムとシームレスに連携できます。

Note: これは jemgold/capacities-mcp のフォークで、追加機能と修正が含まれています。

オリジナル版との違い

機能	オリジナル	Plus
オブジェクトの内容を読む	利用できません	オブジェクト ID でノートの全内容を取得
fastmcp のバージョン	1.27.3	3.25.4（MCP SDK との互換性を修正）
Windows のサポート	問題が発生する場合があります	cmd ラッパーでテスト済み
npm パッケージ	capacities-mcp	capacities-mcp-plus

新しいツール：capacities_read_object_content

ID を指定して、任意の Capacities オブジェクトの全内容を取得します：

• まず、直接取得のために非公開の API エンドポイントを試します
• 直接アクセスできない場合は、検索 API の結果を集約して取得します
• 検索精度を高めるための title パラメーターを指定できます

機能

この MCP サーバーから、現在利用可能なすべての Capacities API エンドポイントにアクセスできます：

• スペース一覧 - 個人用スペースをすべて取得します
• スペース情報 - 詳細なスペース構造とコレクションを取得します
• コンテンツ検索 - 高度なフィルタリングを使ってスペースを横断検索します
• オブジェクトの内容を読む - オブジェクト ID でノートの全内容を取得します
• Web リンクの保存 - メタデータとともに URL をスペースに保存します
• デイリーノート - デイリーノートにコンテンツを追加します

インストール

Claude Desktop（macOS）の場合

Claude Desktop の設定（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "capacities": {
      "command": "npx",
      "args": ["-y", "capacities-mcp-plus"],
      "env": {
        "CAPACITIES_API_KEY": "your_capacities_api_key_here"
      }
    }
  }
}

Claude Desktop（Windows）の場合

Windows では cmd ラッパーが必要です。%APPDATA%\Claude\claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "capacities": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "capacities-mcp-plus"],
      "env": {
        "CAPACITIES_API_KEY": "your_capacities_api_key_here"
      }
    }
  }
}

Capacities アカウント設定から Capacities API キーを取得してください。

これで完了です！Claude Desktop の起動時に、サーバーが自動的にダウンロードされて実行されます。

開発

ローカル環境のセットアップ

ローカルで開発するには、プロジェクトをクローンしてビルドする必要があります：

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

git clone https://github.com/Im-Hal-9K/capacities-mcp.git
cd capacities-mcp

2. 依存関係をインストールします：

npm install
# or
bun install

3. 環境設定ファイルのサンプルをコピーします：

cp .env.example .env

4. .env に Capacities API キーを追加します：

CAPACITIES_API_KEY=your_api_key_here

5. サーバーをビルドします：

npm run build

サーバーの実行

インタラクティブモードで開発サーバーを起動します：

bun run dev

本番環境で使用する場合：

npm run start

サーバーのツールとスキーマを確認するには：

bun run inspect

テスト

テストスイートを実行します：

bun run test

コード品質

リンティングと型を確認します：

bun run lint

コードをフォーマットします：

bun run format

API リファレンス

Capacities アカウント設定から Capacities API キーを取得してください。

詳細な API ドキュメントについては、以下を参照してください：

• Capacities API ドキュメント
• OpenAPI スキーマ

利用可能なツール

capacities_list_spaces

個人用スペースの一覧を取得します。

capacities_get_space_info

構造やコレクションを含む、特定のスペースの詳細情報を取得します。

• spaceId：スペースの UUID

capacities_search

必要に応じてフィルタリングしながら、スペースを横断してコンテンツを検索します。

• searchTerm：検索するテキスト
• spaceIds：検索対象のスペース UUID の配列
• mode（任意）：検索モード（"fullText" または "title"）
• filterStructureIds（任意）：特定の構造タイプで絞り込みます

capacities_read_object_content

ID を指定して Capacities オブジェクトの全コンテンツを取得します。

• objectId：取得するオブジェクトの UUID（Capacities の「オブジェクト参照をコピー」から取得できます）
• spaceId：オブジェクトを含むスペースの UUID
• title（任意）：オブジェクトのタイトルまたはタイトルの一部。検索結果の精度を高めるため、指定を強くおすすめします
• 仕組み：
  1. まず、ドキュメント化されていない GET エンドポイントを使用して、オブジェクトを直接取得しようとします
  2. 取得できない場合は検索 API にフォールバックし、ハイライトとスニペットのコンテンツを集約します
  3. 検索結果をオブジェクト ID でフィルタリングし、完全に一致するものを探します
• 注：検索にフォールバックした場合、検索スニペットからコンテンツを組み立てるため、内容が不完全になることがあります。title パラメーターを指定すると、結果の精度が大幅に向上します。

capacities_save_weblink

任意のメタデータを付けて、ウェブリンクをスペースに保存します。

• spaceId：保存先のスペースの UUID
• url：保存する URL
• titleOverwrite（任意）：リンクのカスタムタイトル
• descriptionOverwrite（任意）：説明文
• tags（任意）：タグの配列。タグ名は Capacities 内のタグ名と完全に一致させる必要があります。一致しない場合は新しく作成されます。
• mdText（任意）：メモ欄に追加する Markdown 形式のテキスト

capacities_save_to_daily_note

Markdown コンテンツをスペースの今日の日次ノートに追加します。

• spaceId：スペースの UUID
• mdText：追加する Markdown コンテンツ
• origin（任意）：コンテンツの起点ラベル（「commandPalette」のみ対応）
• noTimestamp（任意）：true の場合、ノートにタイムスタンプは追加されません

レート制限

Capacities API には、次のレート制限があります。

• /spaces：60 秒あたり 5 リクエスト
• /space-info：60 秒あたり 5 リクエスト
• /search：60 秒あたり 120 リクエスト
• /save-weblink：60 秒あたり 10 リクエスト
• /save-to-daily-note：60 秒あたり 5 リクエスト

プロンプトの例

この MCP サーバーを設定すると、Claude で次のようなプロンプトを使用できます。

はじめに

"Show me all my Capacities spaces"
"What spaces do I have in Capacities?"

ナレッジベースの探索

"Get detailed information about my main workspace in Capacities"
"What structures and collections are in my [space name] space?"

コンテンツの検索

"Search for 'project management' across all my Capacities spaces"
"Find all notes mentioning 'machine learning' in my research space"
"Search for 'meeting notes' but only check titles, not full content"

コンテンツの読み取り

"Read the content of object [object-id] from my research space"
"Get the full note content for [title] in my workspace"

情報の保存

"Save this article to my research space: https://example.com/article"
"Bookmark this GitHub repo in my coding space with tags 'javascript' and 'tools'"
"Save this link with a custom title and description to my resources space"

日次ノート

"Add a summary of today's key insights to my daily note"
"Save these meeting notes to today's daily note in my work space"
"Add this quote to my daily note: [your quote here]"

高度な使い方

"Search for 'productivity' in my work and personal spaces, but filter to only show task-related structures"
"Save this research paper to my academic space and add it to today's daily note as well"
"Find all my notes about 'AI tools' and then save the best ones as bookmarks"

クレジット

• オリジナルプロジェクト： Jem Gold
• 機能強化： Im-Hal-9K

ライセンス

MIT — 詳細は LICENSE ファイルをご覧ください。