使用说明

项目简介

MCP Compass 是一个 MCP (Model Context Protocol) 服务器发现与推荐服务。它就像一个智能指南，帮助 AI 助手根据用户的自然语言查询，从互联网上探索并推荐合适的 MCP 服务器。通过 MCP Compass，AI 助手可以更轻松地找到并利用各种外部工具和服务，扩展自身的能力。

主要功能点

智能搜索: 使用自然语言查询 MCP 服务器。例如，你可以提问 "需要一个用于处理 Stripe 支付的 MCP 服务器" 或 "寻找一个可以连接到 Airtable 的 MCP 服务"。
MCP 服务器推荐: 根据查询内容，从 MCP 服务器注册中心检索并推荐相关的 MCP 服务器。
详细信息展示: 返回推荐的 MCP 服务器的标题、描述、GitHub URL 和相似度评分等详细信息。
易于集成: 可以轻松集成到任何兼容 MCP 协议的 AI 助手，例如 Claude Desktop。

安装步骤

无需安装，可以直接使用 'npx' 命令运行，或者克隆仓库后运行。

方法一：使用 'npx' (推荐) 无需克隆仓库，直接通过 'npx' 命令运行 MCP Compass。

方法二：克隆仓库

克隆 GitHub 仓库到本地：

git clone https://github.com/liuyoshio/mcp-compass
cd mcp-compass

构建项目（如果需要，本例中 'npx' 方式不需要构建）：

npm install
npm run build

服务器配置

要将 MCP Compass 配置为 MCP 服务器供 MCP 客户端（如 Claude Desktop）使用，您需要在客户端的 MCP 配置中添加以下信息。

配置信息 (JSON 格式):

{
  "mcpServers": {
    "mcp-compass": {
      "command": "npx",
      "args": [
        "-y",
        "@liuyoshio/mcp-compass"
      ]
    }
  }
}

参数说明:

'"mcp-compass"': 服务器名称，可以自定义，用于在客户端配置中标识该服务器。
'"command": "npx"': 运行 MCP Compass 服务器的命令，这里使用 'npx' 直接运行 npm 包。
'"args": ["-y", "@liuyoshio/mcp-compass"]': 传递给 'npx' 命令的参数。
- '"-y"': 'npx' 参数，表示自动确认安装 npm 包（如果尚未安装）。
- '"@liuyoshio/mcp-compass"': 要运行的 npm 包名称，即 MCP Compass 的 npm 包。

或者，如果您克隆了仓库并构建了项目，可以使用以下配置：

{
  "mcpServers": {
    "mcp-compass": {
      "command": "node",
      "args": [
        "/path/to/repo/build/index.js"  // 将 "/path/to/repo" 替换为您的仓库本地路径
      ]
    }
  }
}

请将 '/path/to/repo' 替换为您克隆的 'mcp-compass' 仓库在本地的实际路径。

对于 Claude Desktop 客户端，您需要编辑 'claude_desktop_config.json' 文件，并将上述 JSON 配置添加到 'mcpServers' 字段中。

MacOS/Linux: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '$env:AppData\Claude\claude_desktop_config.json'

基本使用方法

配置 MCP 客户端: 按照上述 "服务器配置" 部分，将 MCP Compass 配置添加到您的 MCP 客户端 (例如 Claude Desktop) 的配置文件中。
启动 MCP 客户端: 启动您的 MCP 客户端应用程序。客户端会自动连接到 MCP Compass 服务器。
在 AI 助手中使用: 当 AI 助手需要查找外部 MCP 工具时，它会自动调用 MCP Compass 服务器。您可以通过自然语言指示 AI 助手寻找特定类型的 MCP 服务器。例如，您可以对 Claude 提问：
- "帮我找找有没有可以连接到 Google Sheets 的 MCP 服务器？"
- "我需要一个处理 Twitter API 的 MCP 服务。"
- "有没有适用于 AWS Lambda 部署的 MCP 服务器？"
MCP Compass 将根据您的查询，返回推荐的 MCP 服务器列表及其详细信息，供 AI 助手进一步使用。

注意: MCP Compass 本身不提供直接的工具或资源访问能力，它是一个发现服务，帮助 AI 助手找到其他 MCP 服务器。

关键词