MCP服务器发现工具

PulseMCP Server是一个模型上下文协议(MCP)服务器,提供通过PulseMCP API发现和探索MCP服务器及集成的工具。

  • by orliesaurus
  • JavaScript
  • 本地部署
  • 30 星标
  • 更新于
在 GitHub 查看 orliesaurus/pulsemcp-server

使用说明

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
  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build

用法

运行服务器

服务器可以在构建后直接运行:

./build/index.js

或者通过npm:

npm start

发展

要观察开发过程中的变化:

npm run watch

要检查服务器的MCP实现:

npm run inspector

可用工具

list_server

列出具有可选过滤和分页功能的MCP服务器。

参数:

  • query (可选):用于筛选服务器的搜索词
  • integrations (可选):用于过滤的集成块数组
  • count_per_page (可选):每页结果数(最大值:5000)
  • offset (可选):分页时要跳过的结果数

例子:

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

list_集成

列出所有可用的集成。此工具不接受任何参数。

响应格式

这两个工具都返回具有以下结构的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": [
    {
      "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
  • 轴距:^1.7.9
  • TypeScript:^5.3.3

许可证

阅读许可证。医学博士

贡献

打开一个PR——友善一点,你会得到回报的!