MCP服务器搜索工具

一个用于查询和发现官方MCP服务器库中可用MCP服务器的工具,提供列表浏览、搜索、随机发现等功能。

  • by atonomus
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 atonomus/mcp-servers-search

使用说明

MCP服务器搜索

MCP(模型上下文协议)服务器,提供从官方网站查询和发现可用MCP服务器的工具 模型上下文协议/服务器 存储库。

截至2025年6月,共有547台MCP服务器。

特性

  • 列出服务器:按类别筛选浏览所有可用的MCP服务器
  • 搜索:按名称、描述或作者查找服务器
  • 特征搜索:发现提供特定功能的服务器
  • 随机发现:获取用于探索的随机服务器建议
  • 缓存:高效缓存,最大限度地减少GitHub API调用

安装

使用npm

npm install -g @atonomus/mcp-servers-search

来源

git clone https://github.com/atonomus/mcp-servers-search.git
cd mcp-servers-search
npm install

用法

独立

# Run directly with npx
npx @atonomus/mcp-servers-search

# Or if installed globally
mcp-servers-search

使用克劳德桌面

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "servers-search": {
      "command": "npx",
      "args": ["-y", "@atonomus/mcp-servers-search"]
    }
  }
}

可用工具

1.列表服务器

列出所有具有可选筛选功能的可用MCP服务器。

参数:

  • category (可选):按类别筛选-“引用”、“官方”、“社区”或“全部”(默认)
  • search (可选):按名称或描述搜索服务器
  • limit (可选):最大结果数(默认值:20)

例子:

{
  "name": "list_servers",
  "arguments": {
    "category": "official",
    "search": "database",
    "limit": 10
  }
}

2.获取服务器详细信息

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

参数:

  • name (必填):MCP服务器的名称

例子:

{
  "name": "get_server_details",
  "arguments": {
    "name": "GitHub"
  }
}

3.搜索服务器byfeature

搜索提供特定功能或能力的服务器。

参数:

  • feature (必填):要搜索的功能(例如,“数据库”、“api”、“区块链”)
  • limit (可选):最大结果数(默认值:10)

例子:

{
  "name": "search_servers_by_feature",
  "arguments": {
    "feature": "blockchain",
    "limit": 5
  }
}

4.获取随机服务器

随机选择MCP服务器进行发现。

参数:

  • count (可选):随机服务器数量(默认值:5)
  • category (可选):按类别筛选(默认:“全部”)

例子:

{
  "name": "get_random_servers",
  "arguments": {
    "count": 3,
    "category": "community"
  }
}

5.刷新服务器列表

强制刷新GitHub上缓存的MCP服务器列表。

例子:

{
  "name": "refresh_server_list",
  "arguments": {}
}

发展

设置

# Install dependencies
npm install

# Run normally
npm start

# Run tests
npm test

测试

该项目包括一个全面的Mocha测试套件,用于测试README解析功能。测试包括:

  • 标准格式条目: [Name](link) - description
  • 粗体格式条目: **[Name](link)** - description
  • 列表格式条目: - [Name](link) - description
  • 作者摘录: (by AuthorName)
  • 类别检测(参考、官方、社区)
  • 说明清理(删除嵌入链接)
  • 特殊字符处理(保留回溯)

使用以下工具运行测试:

npm test

例子

与Claude Desktop一起使用

配置后,您可以询问Claude:

  • “哪些MCP服务器可用于数据库操作?”
  • “显示所有官方MCP服务器”
  • “查找与AI或机器学习相关的MCP服务器”
  • “给我5个随机的社区服务器来探索”
  • “告诉我更多关于GitHub MCP服务器的信息”

程序化使用

// Example of using the server programmatically
import { MCPToolsQueryServer } from '@atonomus/mcp-servers-search';

const server = new MCPToolsQueryServer();
await server.run();

缓存

服务器缓存可用MCP服务器列表1小时,以最大限度地减少对GitHub的API调用。您可以使用强制刷新 refresh_server_list 工具。

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

MIT-有关详细信息,请参阅LICENSE文件

致谢