pulse-subregistry

Pulse Sub-Registry MCP Server

还不了解 MCP？想要及时了解最新动态，最简单的方法就是阅读我们的 PulseMCP 每周通讯。

---

这是一个 MCP（Model Context Protocol）服务，可访问 PulseMCP Sub-Registry，让你浏览和发现 MCP 服务。

此项目由 PulseMCP 构建和维护。

目录

• 亮点
• 功能
• 使用技巧
• 示例
• 设置
  • 先决条件
  • 环境变量
  • Claude Desktop
• 开发

亮点

浏览 MCP 服务：在 PulseMCP Sub-Registry 中搜索和发现 MCP 服务。

获取服务详情：获取特定服务的详细信息，包括版本、描述和代码仓库链接。

支持分页：通过基于游标的分页处理大型结果集。

功能

此服务在 macOS 上使用 Claude Desktop 构建并经过测试，也应该能与其他 MCP 客户端搭配使用。

工具名称	描述
list_servers	浏览 Sub-Registry 中的 MCP 服务，可选择搜索和分页。
get_server	按名称和版本获取特定 MCP 服务的详细信息。
switch_tenant_id	（管理员）在运行时切换当前租户 ID。需设置 SHOW_ADMIN_TOOLS=true 才会显示。

使用技巧

• 使用 list_servers 浏览可用的 MCP 服务。你可以按名称或标题搜索。
• 结果较多时，使用 cursor 参数进行分页。
• 使用 get_server 获取特定服务的详细信息。
• get_server 中的 version 参数默认为 "latest"，也可以指定特定版本。

自动截断

为减少上下文大小，响应会自动截断：

• 字符串超过 200 个字符时，会替换为截断提示
• 深层对象（深度为 6 或更高）超过 500 个字符时，会替换为截断提示

截断值会显示查看完整内容所需的确切 expand_fields 路径：

{
  "description": "[TRUNCATED - use expand_fields: [\"servers[].server.description\"] to see full content]"
}

使用 expand_fields 参数查看特定字段的完整内容：

expand_fields: ["servers[].server.description", "servers[].server.readme"]

示例

浏览服务

User: "What MCP servers are available for GitHub?"
Assistant: I'll search for GitHub-related MCP servers.

[Uses list_servers tool with search: "github"]

I found several GitHub-related MCP servers:
- @anthropic/mcp-server-github - Official GitHub integration
- github-issues-server - Manage GitHub issues
...

获取服务详情

User: "Tell me more about the filesystem MCP server"
Assistant: I'll get the details for that server.

[Uses get_server tool with server_name: "@anthropic/mcp-server-filesystem"]

The filesystem MCP server (version 1.0.0) provides:
- Description: Access and manage local filesystem
- Repository: https://github.com/anthropics/mcp-servers
...

分页

User: "Show me more servers"
Assistant: I'll get the next page of results.

[Uses list_servers tool with cursor from previous response]

Here are more servers...

设置

先决条件

• Node.js（建议使用 v18 或更高版本）
• PulseMCP API 密钥（可在 https://www.pulsemcp.com/ 获取）
• Claude Desktop 应用程序（用于本地设置）

环境变量

环境变量	描述	必需	默认值
PULSEMCP_SUBREGISTRY_API_KEY	你的 PulseMCP API 密钥	是	不适用
PULSEMCP_SUBREGISTRY_TENANT_ID	你的租户标识符（用于多租户场景）	否	不适用
SHOW_ADMIN_TOOLS	设置为 true 以启用管理员工具（switch_tenant_id）	否	false

Claude Desktop

本地设置

要运行本地版本，你需要在机器上安装 Node.js。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

将此配置添加到 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "pulse-subregistry": {
      "command": "npx",
      "args": ["-y", "@pulsemcp/pulse-subregistry"],
      "env": {
        "PULSEMCP_SUBREGISTRY_API_KEY": "your-api-key-here"
      }
    }
  }
}

设置本地版本：

1. 克隆或下载此仓库
2. 切换到本地目录：cd pulse-subregistry/local
3. 安装依赖项：npm install
4. 构建项目：npm run build
5. 使用正确的路径更新 Claude Desktop 配置
6. 重启 Claude Desktop

开发

项目结构

pulse-subregistry/
├── local/                 # Local server implementation
│   ├── src/
│   │   └── index.ts      # Main entry point
│   ├── build/            # Compiled output
│   └── package.json
├── shared/               # Shared business logic
│   ├── src/
│   │   ├── server.ts     # Server factory
│   │   ├── tools.ts      # Tool registration
│   │   ├── tools/        # Individual tools
│   │   ├── client.ts     # API client
│   │   └── types.ts      # Type definitions
│   └── package.json
└── tests/                # Test suite
    ├── functional/       # Unit tests
    └── integration/      # Integration tests

在开发模式下运行

# Build shared module first
cd shared
npm install
npm run build

# Run local server in development
cd ../local
npm install
npm run dev

测试

# Install all dependencies
npm run install-all

# Run unit tests
npm test

# Run integration tests
npm run test:integration

# Run all tests
npm run test:all

代码检查与格式化

# Check for linting issues
npm run lint

# Auto-fix linting issues
npm run lint:fix

# Format all code
npm run format

工具参考

list_servers

浏览 PulseMCP Sub-Registry 中的 MCP 服务。

参数：

• limit（数字，可选）：要返回的 MCP 服务数量上限（1-100）。默认值：30。
• cursor（字符串，可选）：上一响应中的分页游标。
• search（字符串，可选）：用于按名称或标题筛选 MCP 服务的搜索词。
• updated_since（字符串，可选）：用于筛选此日期之后更新的 MCP 服务的 ISO 8601 时间戳。示例："2024-01-01T00:00:00Z"。
• latest_only（布尔值，可选）：若为 true（默认值），则仅返回每个 MCP 服务的最新版本。设为 false 可包含所有版本。
• expand_fields（数组，可选）：要完整显示（不截断）的点分隔路径数组。默认情况下，长字符串会被截断。示例：["servers[].server.description", "servers[].server.readme"]。

get_server

获取特定 MCP 服务的详细信息。

参数：

• server_name（字符串，必需）：要查询的 MCP 服务名称。
• version（字符串，可选）：要获取的特定版本。默认值："latest"。
• expand_fields（数组，可选）：要完整显示（不截断）的点分隔路径数组。示例：["server.description", "server.readme"]。

switch_tenant_id

切换后续 API 请求使用的活动租户 ID。这是一个默认隐藏的管理工具。设置 SHOW_ADMIN_TOOLS=true 可启用此工具。

参数：

• tenant_id（字符串，必需）：要切换到的租户 ID。传入空字符串可清除租户 ID 并恢复为默认值。

许可证

MIT