Pulsemcp Server

🚀 パルス MCP サーバー

パルス MCP 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（オプション）：ページごとの結果数（最大値：5000）
• offset（オプション）：スキップする結果数

例：

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

list_integrations

すべての利用可能な統合をリスト表示します。このツールはパラメータを受け付けません。

レスポンス形式

両方のツールは JSON 形式のレスポンスを返し、以下の構造を持ちます。

list_servers レスポンス

{
  "servers": [
    {
      "name": "サーバー名",
      "url": "https://example.com",
      "external_url": "https://外部リンク.com",
      "short_description": "サーバーの説明",
      "source_code_url": "https://github.com/example/repo",
      "github_stars": 123,
      "package_registry": "npm",
      "package_name": "パッケージ名",
      "package_download_count": 1000,
      "integrations": [
        {
          "name": "統合名",
          "slug": "統合タグ",
          "url": "https://integration-url.com"
        }
      ]
    }
  ],
  "total_count": 1,
  "next": null
}

list_integrations レスポンス

{
  "integrations": [
    {
      "name": "統合名",
      "slug": "統合タグ",
      "url": "https://integration-url.com"
    }
  ]
}

🔧 技術詳細

サーバーには堅牢なエラー処理機能が備わっています：

• 無効なパラメータ
• API 接続問題
• 制限付きの流量
• 認証エラー

エラーは標準形式で返され、適切なエラーコードとメッセージが含まれます。

プロジェクト構造

pulsemcp-server/
{
  "name": "サーバー名",
  "url": "https://example.com",
  "external_url": "https://外部リンク.com",
  "short_description": "サーバーの説明",
  "source_code_url": "https://github.com/example/repo",
  "github_stars": 123,
  "package_registry": "npm",
  "package_name": "パッケージ名",
  "package_download_count": 1000,
  "integrations": [
    {
      "name": "統合名",
      "slug": "統合タグ",
      "url": "https://integration-url.com"
    }
  ]
}

依存関係

• express: "^4.18.2"
• cors: "^2.8.5"
• dotenv: "^16.0.3"

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については LICENSE ファイルを参照してください。

コントリビューションガイド

このプロジェクトへの貢献を歓迎します！参加方法については CONTRIBUTING.md ファイルを参照してください。