mcp注册表接口
🔍 用于与官方模型上下文协议注册表接口的MCP服务器
使Claude和其他MCP客户端能够直接从GitHub动态发现、浏览、搜索和管理MCP服务器。从官方MCP服务器存储库获取实时数据。
🚀 特性
- 🔍 实时搜索 -从实时GitHub数据中查找MCP服务器
- 📦 服务器详细信息 -获取包括安装指南在内的全面信息
- 📂 分类 -按功能（文件系统、数据库等）浏览服务器
- 🔄 自动刷新 -具有可配置刷新间隔的缓存数据
- 🔒 了解费率限制 -支持更高API限制的GitHub令牌
- ❌ 无模拟数据 -始终提供真实数据或透明失败
📋 可用工具
| 工具 | 说明 |
|---|---|
registry_search_servers | 按名称、描述或标签搜索MCP服务器 |
registry_get_server_details | 获取详细的服务器信息和安装指南 |
registry_list_categories | 列出所有服务器类别及其说明 |
registry_refresh_data | 强制刷新GitHub数据（绕过缓存） |
🛠️ 安装
NPM（推荐）
npx mcp-registry-interface手动安装
git clone
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调用。有了令牌，你每小时会接到5000个电话。
🎯 示例用法
User: "Find MCP servers for working with databases"
Claude: Uses registry_search_servers with category="database"
User: "Show me details about the filesystem server"
Claude: Uses registry_get_server_details with serverId="mcp-filesystem"
User: "What categories of MCP servers are available?"
Claude: Uses registry_list_categories🔒 安全性和可靠性
- ✅ 仅限真实数据 -没有可能误导开发人员的模拟/虚假数据
- ✅ 透明故障 -当GitHub API不可用时清除错误消息
- ✅ 费率限制处理 -正确的GitHub API速率限制管理
- ✅ 输入验证 -安全的参数检查和净化
- ✅ 没有硬编码的秘密 -来自环境变量的所有令牌
🧪 开发与测试
服务器从GitHub的API获取实时数据：
# Basic usage (60 requests/hour)
node src/index.js
# With GitHub token (5000 requests/hour)
GITHUB_TOKEN=your_token_here node src/index.js
# Test the server
node static-test.js🛡️ 错误处理
当GitHub API不可用时，服务器：
- ❌ 不提供虚假/模拟数据
- ✅ 返回明确的错误消息
- ✅ 解释如何解决问题
- ✅ 维护最近成功请求的缓存
🤝 贡献
该工具通过使服务器发现与真实、最新的信息无缝衔接，帮助加速MCP生态系统。
- 分叉存储库
- 创建要素分支
- 进行更改
- 使用实时GitHub数据进行测试
- 提交拉取请求
📚 数据源
- 主要来源: 模型上下文协议/服务器 自述
- API：GitHub内容API
- 更新频率：5分钟缓存，具有手动刷新功能
- 解析：提取官方参考服务器和社区服务器
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件。
______________________________________________________________________
🎯 哲学：该工具相信透明度——真实数据或诚实的失败，从不误导模拟数据。