mcp-registry-interface

🔍 与官方模型上下文协议注册表接口的MCP服务器

使Claude和其他MCP客户端能够从GitHub动态发现、浏览、搜索和管理MCP服务器。从官方MCP服务器仓库获取实时数据。

🚀 特性

• 🔍 实时搜索 - 根据实时GitHub数据查找MCP服务器
• 📦 服务器详情 - 获取包括安装指南在内的全面信息
• 📂 分类 - 按功能（文件系统、数据库等）浏览服务器
• 🔄 自动刷新 - 带有可配置刷新间隔的缓存数据
• 🔒 支持速率限制 - 支持GitHub令牌以提高API限制
• ❌ 不提供模拟数据 - 总是提供真实数据或透明失败

📋 可用工具

工具	描述
registry_search_servers	按名称、描述或标签搜索MCP服务器
registry_get_server_details	获取详细的服务器信息和安装指南
registry_list_categories	列出所有服务器类别及其描述
registry_refresh_data	强制刷新GitHub数据（绕过缓存）

🛠️ 安装

NPM（推荐）

npx mcp-registry-interface

手动安装

git clone <repository-url>
cd mcp-registry-interface
npm install
npm start

⚙️ 配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "registry-interface": {
      "command": "npx",
      "args": ["mcp-registry-interface"],
      "env": {
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

环境变量

变量	描述	必需
GITHUB_TOKEN	GitHub个人访问令牌以提高速率限制	否（无令牌时每小时60次请求）

没有GitHub令牌时，你每小时可以进行60次API调用。有了令牌，你可以进行5,000次调用。

🎯 示例用法

用户: "查找用于处理数据库的MCP服务器"
Claude: 使用registry_search_servers并设置category="database"

用户: "显示关于文件系统服务器的详细信息"
Claude: 使用registry_get_server_details并设置serverId="mcp-filesystem"

用户: "有哪些类别的MCP服务器可用？"
Claude: 使用registry_list_categories

🔒 安全性和可靠性

• ✅ 仅真实数据 - 不提供可能误导开发者的模拟/假数据
• ✅ 透明失败 - 当GitHub API不可用时，返回清晰的错误消息
• ✅ 速率限制处理 - 正确管理GitHub API的速率限制
• ✅ 输入验证 - 安全的参数检查和清理
• ✅ 不硬编码秘密 - 所有令牌来自环境变量

🧪 开发与测试

该服务器从GitHub的API获取实时数据：

# 基本使用（每小时60次请求）
node src/index.js

# 使用GitHub令牌（每小时5000次请求）
GITHUB_TOKEN=your_token_here node src/index.js

# 测试服务器
node static-test.js

🛡️ 错误处理

当GitHub API不可用时，服务器：

• ❌ 不提供模拟/假数据
• ✅ 返回清晰的错误消息
• ✅ 解释如何解决问题
• ✅ 维护最近成功请求的缓存

🤝 贡献

此工具通过提供真实、最新的信息来加速MCP生态系统，使服务器发现无缝进行。

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 使用实时GitHub数据进行测试
5. 提交拉取请求

📚 数据源

• 主要来源：modelcontextprotocol/servers README
• API：GitHub内容API
• 更新频率：5分钟缓存，带有手动刷新能力
• 解析：提取官方参考服务器和社区服务器

📄 许可证

MIT许可证 - 查看LICENSE文件了解详情。

---

🎯 理念：此工具相信透明度 - 真实数据或诚实失败，从不提供误导性的模拟数据。