Pulsemcp Server

🚀 脈搏 MCP 服務器

脈搏 MCP 服務器是一個提供工具以發現和探索 MCP 服務器及其集成的 Model Context Protocol (MCP) 服務器，可通過脈搏 MCP API 進行操作。它能幫助用戶高效地管理和使用 MCP 服務器資源。

🚀 快速開始

脈搏 MCP 服務器提供了便捷的方式來發現和探索 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"
    }
  ]
}

🔧 技術細節

錯誤處理

服務器包含 robust 的錯誤處理功能：

• 無效參數
• 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 文件瞭解如何參與。