mcp-compass 的安装和配置教程

1. 项目基础介绍和主要编程语言

mcp-compass 是一个开源项目，旨在提供一个 Model Context Protocol (MCP) 服务的发现与推荐服务。该服务能够帮助用户通过自然语言查询来探索和了解可用的 MCP 服务，以便更容易地发现和利用适合特定任务的工具。该项目主要使用 JavaScript 编程语言开发。

2. 项目使用的关键技术和框架

该项目利用了以下关键技术和框架：

• Node.js：作为运行 JavaScript 代码的服务器端环境。
• npm 或 pnpm：作为包管理工具，用于管理项目中的依赖。
• tsconfig.json：TypeScript 的配置文件，用于指定编译选项。

3. 项目安装和配置的准备工作及详细步骤

在开始安装 mcp-compass 前，请确保您的系统中已经安装了以下软件：

• Node.js（建议版本 LTS）
• npm 或 pnpm（推荐使用 pnpm 以获得更好的性能）

安装步骤

1. 克隆项目仓库

   打开命令行界面，执行以下命令克隆仓库到本地：

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

2. 安装依赖

   进入项目目录，安装所需的依赖：

   使用 npm：

   cd mcp-compass
   npm install
   

   或者，如果您使用 pnpm：

   cd mcp-compass
   pnpm install
   

3. 配置 AI 助手的 MCP 配置

   根据您的 AI 助手，将以下配置添加到对应的配置文件中，以启用服务发现功能。

   对于 Claude Desktop 用户，需要编辑 claude_desktop_config.json 文件：

   • 在 MacOS/Linux 系统上，该文件的路径通常是 ~/Library/Application Support/Claude/claude_desktop_config.json。
   • 在 Windows 系统上，该文件的路径通常是 $env:AppData\Claude\claude_desktop_config.json。

   在配置文件中添加以下内容：

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

   或者，使用 Node.js 执行以下命令：

   {
     "mcpServers": {
       "mcp-compass": {
         "command": "node",
         "args": ["/path/to/repo/build/index.js"]
       }
     }
   }
   

   请确保将 /path/to/repo/build/index.js 替换为实际的文件路径。

完成以上步骤后，mcp-compass 应该已经成功安装并配置好了。您现在可以开始使用该服务来发现和推荐 MCP 服务了。