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