JinDaGe - pulsemcp-server MCP Details

article

README

🚀 脉搏 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"]
    }
  }
}

克隆仓库：

git clone <repository-url>
cd pulsemcp-server

安装依赖项：

npm install

构建项目：

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 文件了解如何参与。

pulsemcp-server