AI导哈

MCP注册表接口服务

一个用于动态发现、浏览、搜索和管理MCP服务器的工具，直接从GitHub获取实时数据，支持多种功能如实时搜索、服务器详情获取和分类浏览。

  • by MikeyBeez
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 MikeyBeez/mcp-registry-interface

使用说明

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 <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调用。有了令牌，你每小时会接到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生态系统。

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

📚 数据源

  • 主要来源: 模型上下文协议/服务器 自述
  • API：GitHub内容API
  • 更新频率：5分钟缓存，具有手动刷新功能
  • 解析：提取官方参考服务器和社区服务器

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

🎯 哲学：该工具相信透明度——真实数据或诚实的失败，从不误导模拟数据。

相关 MCP