Mcp Mcp

MCP-MCP：Meta-MCP 服务

MCP-MCP 是一个 Meta-MCP 服务，作为 Model Context Protocol（MCP） 的工具发现与提供服务。当 AI 助手需要当前不可用的能力时，可以向 MCP-MCP 请求，从汇集了多个精选来源、包含上千个服务的综合数据库中发现并推荐合适的 MCP 服务。

可以把它看作 MCP 服务的“电话簿”——用一个工具查找所有其他工具。

🗃️ 2,874+ 个 MCP 服务可用

MCP-MCP 提供对综合数据库的访问，该数据库汇集了多个精选来源的内容，包括：

• 官方 MCP 服务（modelcontextprotocol/servers）
• 社区精选集（Punkpeye 和 Appcypher 的 awesome 列表）
• 智能去重确保不同来源之间没有重复内容

数据库每 3 小时自动更新一次，加入社区最新的服务。

动机

Agent 只想要工具

• Agent 清楚自己需要什么：AI 助手可以清晰地说明需求，例如“检查域名是否可用”或“获取天气数据”
• 网页搜索并非总能满足需求：通用搜索结果不一定能提供实时数据
• CLI 工具需要配置：许多工具需要复杂的安装、配置和 API 密钥——Agent 每次需要完成任务时都得重复这些设置
• MCP 服务分散各处：虽然有很多出色的工具，但要发现它们，需要在 GitHub、论坛和文档中手动搜寻

既然可以把工具送到 Agent（和用户）面前，何必让他们四处寻找呢？

快速开始

Claude Desktop 配置

将 MCP-MCP 添加到 Claude Desktop 配置文件中：

配置文件位置：

• macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

配置：

{
  "mcpServers": {
    "mcp-mcp": {
      "command": "uvx",
      "args": ["mcp-mcp"]
    }
  }
}

使用 pipx 的替代方式：

{
  "mcpServers": {
    "mcp-mcp": {
      "command": "mcp-mcp"
    }
  }
}

Claude Code 配置

将 MCP-MCP 添加到 Claude Code 配置文件中：

claude mcp add mcp-mcp uvx mcp-mcp

使用示例

配置完成后，你可以用自然语言让 Claude Desktop 查找 MCP 服务：

• “帮我找一个提供天气数据的 MCP 服务”
• “我需要一个检查域名是否可用的服务”
• “搜索与股票市场数据相关的 MCP 服务”
• “有哪些可用于网页抓取的 MCP 服务？”

开发

前置条件

• Python 3.13+
• uv 包管理器
• direnv（可选，用于自动设置环境）
• just（可选，用于便捷的开发命令）

设置

# Clone the repository
git clone https://github.com/your-username/mcp-mcp.git
cd mcp-mcp

# Install dependencies
uv sync

# Run tests
uv run pytest

# Run the server
uv run main.py

通过 uvx 安装（用于测试）

测试已安装的软件包：

uvx mcp-mcp

这会通过 uvx 直接安装并运行 MCP-MCP 服务。

开发命令（使用 justfile）

此项目包含一个 justfile，用于执行常见的开发任务：

# List all available commands
just help

# Development with auto-reload
just dev      # STDIO mode with file watching
just dev-http # HTTP mode with file watching

# Running without auto-reload
just run-stdio # STDIO mode
just run-http  # HTTP mode

# Testing
just test             # Unit tests only
just test-integration # Include GitHub integration tests

# Building and publishing
just build           # Build package
just publish-test    # Publish to Test PyPI
just publish-prod    # Publish to Production PyPI

# Utilities
just version # Show version
just clean   # Clean build artifacts

开发模式

开发和测试时，请使用 HTTP 传输（按 Ctrl+C 更容易停止）：

# HTTP mode (accessible at http://localhost:8000)
uv run main.py --http
# OR with justfile:
just run-http

# With auto-reload during development
just dev-http

# Custom host/port
uv run main.py --http --host 0.0.0.0 --port 3000

# STDIO mode (for MCP clients like Claude Desktop)
uv run main.py  # Note: To stop STDIO mode, use Ctrl+D (EOF), not Ctrl+C
# OR with justfile:
just run-stdio

# With auto-reload during development
just dev

构建

# Build package
uv build
# OR with justfile:
just build

# Test local installation
uvx --from ./dist/mcp_mcp-0.1.0-py3-none-any.whl mcp-mcp

命令行选项

mcp-mcp --help

选项	说明	默认值
--transport {stdio,http}	传输方式	stdio
--http	使用 HTTP 传输	-
--host HOST	HTTP 传输的主机	localhost
--port PORT	HTTP 传输的端口	8000

测试

# Run all tests (unit + integration)
uv run pytest
# OR with justfile:
just test

# Run only unit tests (fast, no network)
uv run pytest db/ -v
# OR with justfile:
just test-unit

# Run only integration/e2e tests
uv run pytest tests/ -v
# OR with justfile:
just test-integration

# Run GitHub integration tests (optional, requires network)
MCP_MCP_TEST_GITHUB_INTEGRATION=1 uv run pytest tests/
# OR with justfile:
just test-integration-github

# Run all tests including GitHub integration
MCP_MCP_TEST_GITHUB_INTEGRATION=1 uv run pytest
# OR with justfile:
just test-all

# Run with coverage
uv run pytest --cov=db

测试结构：

• 单元测试：与被测代码一起位于 db/ 中（Go 风格）
• 集成/E2E 测试：位于 tests/ 目录中

集成测试：设置 MCP_MCP_TEST_GITHUB_INTEGRATION=1，即可测试真实的 GitHub 下载，并验证完整的新用户引导体验。这些测试确保用户能够快速启动（< 5 秒），并获得 2,874+ 个服务。

路线图

当前状态：MVP 已完成 ✅

• ✅ 多来源发现（3 个精选来源，2,874+ 个独立服务）
• ✅ 使用预计算嵌入的语义搜索，响应时间不到 1 秒
• ✅ 通过 uvx/pipx 和自动化发布实现生产环境分发
• ✅ 通过来源验证中间件强化安全性
• ✅ 全面的测试覆盖（65+ 个测试）
• ✅ 完整的文档和开发工作流

后续增强（超出 MVP 范围）

• Docker 集成，实现服务器自动容器化
• MCP 协议代理，实现无缝的服务器执行
• GitHub API 集成，实现实时服务器发现
• 服务器生命周期管理和清理
• 私有注册表支持
• 依赖解析
• 性能监控
• 用于服务器管理的 Web UI

贡献

欢迎贡献！请参阅我们的开发环境设置，并按以下步骤操作：

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

开发指南

• 遵循 Python 3.13+ 最佳实践
• 为新功能添加测试
• 根据需要更新文档
• 使用语义化提交消息

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

致谢

• Anthropic 的 Model Context Protocol 团队
• 开源 MCP 服务的维护者和贡献者
• MCP 服务列表：
  • 官方 MCP 服务
  • Punkpeye 的 Awesome MCP Servers
  • Appcypher 的 Awesome MCP Servers

---

为 MCP 生态系统倾情打造 ❤️