PulseMCP Server

PulseMCP サーバー

PulseMCP API を通じて MCP サーバーとインテグレーションを検出・探索するためのツールを提供する Model Context Protocol (MCP) サーバーです。

機能

• フィルタリングとページネーションに対応した利用可能な MCP サーバーの一覧表示
• 名前や機能による特定の MCP サーバーの検索
• インテグレーションタイプによるサーバーのフィルタリング
• 利用可能なすべてのインテグレーションの一覧表示
• TypeScript の完全サポート

インストール

MCP クライアントへのインストール

これを MCP クライアントの設定に追加し、お使いのクライアントの設定に合わせて調整してください。例：

{
  "mcpServers": {
    "pulsemcp": {
      "command": "npx",
      "args": ["-y", "pulsemcp-server"]
    }
  }
}

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

git clone <repository-url>
cd pulsemcp-server

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

npm install

3. プロジェクトをビルドします：

npm run build

使用方法

サーバーの実行

サーバーはビルド後に直接実行できます：

./build/index.js

または npm 経由で：

npm start

開発

開発中に変更を監視するには：

npm run watch

サーバーの MCP 実装を検査するには：

npm run inspector

利用可能なツール

list_servers

オプションのフィルタリングとページネーションを使用して MCP サーバーを一覧表示します。

パラメータ：

• query（オプション）：サーバーをフィルタリングする検索語
• integrations（オプション）：フィルタリングするインテグレーションスラッグの配列
• count_per_page（オプション）：1 ページあたりの結果数（最大：5000）
• offset（オプション）：ページネーションのためにスキップする結果数

例：

{
  "query": "toolhouse",
  "integrations": ["github"],
  "count_per_page": 10,
  "offset": 0
}

list_integrations

利用可能なすべてのインテグレーションを一覧表示します。このツールはパラメータを取りません。

レスポンス形式

両方のツールは以下の構造を持つ JSON レスポンスを返します：

list_servers のレスポンス

{
  "servers": [
    {
      "name": "Server Name",
      "url": "https://example.com",
      "external_url": "https://external-link.com",
      "short_description": "Server description",
      "source_code_url": "https://github.com/example/repo",
      "github_stars": 123,
      "package_registry": "npm",
      "package_name": "package-name",
      "package_download_count": 1000,
      "integrations": [
        {
          "name": "Integration Name",
          "slug": "integration-slug",
          "url": "https://integration-url.com"
        }
      ]
    }
  ],
  "total_count": 1,
  "next": null
}

list_integrations のレスポンス

{
  "integrations": [
    {
      "name": "Integration Name",
      "slug": "integration-slug",
      "url": "https://integration-url.com"
    }
  ]
}

エラーハンドリング

サーバーは以下に対する堅牢なエラーハンドリングを備えています：

• 無効なパラメータ
• API 接続の問題
• レート制限
• 認証エラー

エラーは適切なエラーコードとメッセージを伴う標準化された形式で返されます。

開発

プロジェクト構造

pulsemcp-server/
├── src/
│   └── index.ts    # Main server implementation
├── build/          # Compiled JavaScript
├── package.json    # Project configuration
└── tsconfig.json   # TypeScript configuration

依存関係

• @modelcontextprotocol/sdk: ^0.6.0
• axios: ^1.7.9
• TypeScript: ^5.3.3

ライセンス

LICENSE.MD をお読みください

コントリビューション

PR を送ってください — 丁寧に対応すれば報われます！