PulseMCP 服务器

一个模型上下文协议（MCP）服务器，通过PulseMCP API提供工具来发现和探索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://external-link.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/
├── src/
│   └── index.ts    # 主服务器实现
├── build/          # 编译后的JavaScript
├── package.json    # 项目配置
└── tsconfig.json   # TypeScript配置

依赖项

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

许可证

阅读LICENSE.MD

贡献

打开PR - 和善一点，你会得到回报！