pulse-subregistry

Pulse サブレジストリ MCP サーバー

MCPについてまだご存じありませんか？最新情報を把握する一番簡単な方法は、PulseMCPの週刊ニュースレターを読むことです。

---

これは、PulseMCP サブレジストリにアクセスし、MCP サーバーの閲覧や検索を可能にする MCP（Model Context Protocol）サーバーです。

このプロジェクトは、PulseMCPによって構築、保守されています。

目次

• 主な特長
• 機能
• 使用上のヒント
• 例
• セットアップ
  • 前提条件
  • 環境変数
  • Claude Desktop
• 開発

主な特長

MCP サーバーを閲覧：PulseMCP サブレジストリから MCP サーバーを検索、発見できます。

サーバーの詳細を取得：バージョン、説明、リポジトリへのリンクなど、特定のサーバーに関する詳細情報を取得できます。

ページネーションに対応：カーソルベースのページネーションで、大量の結果を処理できます。

機能

このサーバーは、Claude Desktop を使用して macOS 上で構築、テストされています。ほかの MCP クライアントでも動作するはずです。

ツール名	説明
list_servers	オプションの検索とページネーションを指定して、サブレジストリの MCP サーバーを閲覧します。
get_server	名前とバージョンを指定して、特定の MCP サーバーに関する詳細情報を取得します。
switch_tenant_id	（管理者向け）実行時にアクティブなテナント ID を切り替えます。表示するには SHOW_ADMIN_TOOLS=true が必要です。

使用上のヒント

• list_servers を使用して、利用可能な MCP サーバーを閲覧します。名前またはタイトルで検索できます。
• 結果が多い場合は、cursor パラメーターを使用してページネーションを行います。
• get_server を使用して、特定のサーバーに関する詳細情報を取得します。
• get_server の version パラメーターはデフォルトで "latest" ですが、特定のバージョンを指定することもできます。

自動切り詰め

コンテキストサイズを減らすため、応答は自動的に切り詰められます。

• 文字列は、200文字を超える場合、切り詰めを示すメッセージに置き換えられます
• 深い階層のオブジェクトは、深さが6以上で500文字を超える場合、切り詰めを示すメッセージに置き換えられます

切り詰められた値には、内容全体を表示するために必要な expand_fields の正確なパスが示されます。

{
  "description": "[TRUNCATED - use expand_fields: [\"servers[].server.description\"] to see full content]"
}

特定のフィールドの内容全体を表示するには、expand_fields パラメーターを使用します。

expand_fields: ["servers[].server.description", "servers[].server.readme"]

例

サーバーの閲覧

User: "What MCP servers are available for GitHub?"
Assistant: I'll search for GitHub-related MCP servers.

[Uses list_servers tool with search: "github"]

I found several GitHub-related MCP servers:
- @anthropic/mcp-server-github - Official GitHub integration
- github-issues-server - Manage GitHub issues
...

サーバーの詳細の取得

User: "Tell me more about the filesystem MCP server"
Assistant: I'll get the details for that server.

[Uses get_server tool with server_name: "@anthropic/mcp-server-filesystem"]

The filesystem MCP server (version 1.0.0) provides:
- Description: Access and manage local filesystem
- Repository: https://github.com/anthropics/mcp-servers
...

ページネーション

User: "Show me more servers"
Assistant: I'll get the next page of results.

[Uses list_servers tool with cursor from previous response]

Here are more servers...

セットアップ

前提条件

• Node.js（推奨：v18以降）
• PulseMCP API キー（https://www.pulsemcp.com/ で取得できます）
• Claude Desktop アプリケーション（ローカルセットアップ用）

環境変数

環境変数	説明	必須	デフォルト
PULSEMCP_SUBREGISTRY_API_KEY	PulseMCP API キー	はい	N/A
PULSEMCP_SUBREGISTRY_TENANT_ID	テナント識別子（マルチテナントでの使用向け）	いいえ	N/A
SHOW_ADMIN_TOOLS	管理者向けツール（switch_tenant_id）を有効にするには true に設定します	いいえ	false

Claude Desktop

ローカルセットアップ

ローカル版を実行するには、マシンに Node.js をインストールする必要があります。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

この設定を Claude Desktop の設定ファイルに追加してください。

{
  "mcpServers": {
    "pulse-subregistry": {
      "command": "npx",
      "args": ["-y", "@pulsemcp/pulse-subregistry"],
      "env": {
        "PULSEMCP_SUBREGISTRY_API_KEY": "your-api-key-here"
      }
    }
  }
}

ローカル版をセットアップするには、次の手順に従ってください。

1. リポジトリをクローンまたはダウンロードします
2. ローカルディレクトリに移動します: cd pulse-subregistry/local
3. 依存関係をインストールします: npm install
4. プロジェクトをビルドします: npm run build
5. Claude Desktop の設定を正しいパスに更新します
6. Claude Desktop を再起動します

開発

プロジェクト構成

pulse-subregistry/
├── local/                 # Local server implementation
│   ├── src/
│   │   └── index.ts      # Main entry point
│   ├── build/            # Compiled output
│   └── package.json
├── shared/               # Shared business logic
│   ├── src/
│   │   ├── server.ts     # Server factory
│   │   ├── tools.ts      # Tool registration
│   │   ├── tools/        # Individual tools
│   │   ├── client.ts     # API client
│   │   └── types.ts      # Type definitions
│   └── package.json
└── tests/                # Test suite
    ├── functional/       # Unit tests
    └── integration/      # Integration tests

開発モードでの実行

# Build shared module first
cd shared
npm install
npm run build

# Run local server in development
cd ../local
npm install
npm run dev

テスト

# Install all dependencies
npm run install-all

# Run unit tests
npm test

# Run integration tests
npm run test:integration

# Run all tests
npm run test:all

リントとフォーマット

# Check for linting issues
npm run lint

# Auto-fix linting issues
npm run lint:fix

# Format all code
npm run format

ツールリファレンス

list_servers

PulseMCP Sub-Registry の MCP サーバーを閲覧します。

パラメーター:

• limit（number、任意）: 返すサーバーの最大数（1～100）。デフォルト: 30。
• cursor（string、任意）: 前回のレスポンスから取得したページネーションカーソル。
• search（string、任意）: サーバーを名前またはタイトルで絞り込む検索語。
• updated_since（string、任意）: この日時以降に更新されたサーバーを絞り込む ISO 8601 タイムスタンプ。例: "2024-01-01T00:00:00Z"。
• latest_only（boolean、任意）: true（デフォルト）の場合、各サーバーの最新バージョンのみを返します。false に設定すると、すべてのバージョンが含まれます。
• expand_fields（array、任意）: 全文を表示する（省略しない）ドット記法のパスの配列。デフォルトでは、長い文字列は省略されます。例: ["servers[].server.description", "servers[].server.readme"]。

get_server

特定の MCP サーバーに関する詳細情報を取得します。

パラメーター:

• server_name（string、必須）: 検索するサーバーの名前。
• version（string、任意）: 取得する特定のバージョン。デフォルト: "latest"。
• expand_fields（array、任意）: 全文を表示する（省略しない）ドット記法のパスの配列。例: ["server.description", "server.readme"]。

switch_tenant_id

後続の API リクエストで使用するアクティブなテナント ID を切り替えます。これはデフォルトでは非表示の管理者向けツールです。有効にするには、SHOW_ADMIN_TOOLS=true を設定してください。

パラメーター:

• tenant_id（string、必須）: 切り替え先のテナント ID。空の文字列を渡すとテナント ID がクリアされ、デフォルトに戻ります。

ライセンス

MIT