STARWARCLOUD STARWAR.AI
返回市场
MCP服务器搜索

MCP服务器搜索

作者：atonomus2 星标更新：2025-06-30
安装使用来源：spider==github.com

项目介绍

MCP服务器搜索

一个提供工具用于查询和发现来自官方 modelcontextprotocol/servers 仓库的可用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

使用方法

单独运行

# 直接使用npx运行
npx @atonomus/mcp-servers-search

# 或者如果全局安装了
mcp-servers-search

与Claude Desktop结合使用

在你的Claude Desktop配置中添加（macOS上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

可用工具

1. 列出服务器

列出所有可用的MCP服务器，可选地进行过滤。

参数：

  • category（可选）：按类别过滤 - "reference", "official", "community" 或 "all"（默认）
  • search（可选）：按名称或描述搜索服务器
  • limit（可选）：结果的最大数量（默认：20）

示例：

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

2. 获取服务器详情

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

参数：

  • name（必需）：MCP服务器的名称

示例：

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

3. 按特性搜索服务器

搜索提供特定特性的服务器。

参数：

  • feature（必需）：要搜索的特性（例如："database", "api", "blockchain"）
  • limit（可选）：结果的最大数量（默认：10）

示例：

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

4. 获取随机服务器

获取一组随机的MCP服务器以供发现。

参数：

  • count（可选）：随机服务器的数量（默认：5）
  • category（可选）：按类别过滤（默认："all"）

示例：

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

5. 刷新服务器列表

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

示例：

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

开发

设置

# 安装依赖
npm install

# 正常运行
npm start

# 运行测试
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服务器的信息"

程序化使用

// 示例程序化使用服务器
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. 打开Pull Request

许可证

MIT - 查看LICENSE文件了解详情

致谢