使用说明

项目简介

该项目包含多个基于 Model Context Protocol (MCP) 的服务器实现，旨在扩展 LLM 应用（如 Cline）的功能。目前提供了两个服务器：'astro-docs-server' 用于访问 Astro 文档，'diff-server' 用于文件差异比较。

主要功能点

astro-docs-server:
- 提供搜索 Astro 文档的功能。
- 支持获取指定 Astro 文档页面的内容。
- 提供了 'search_docs' 和 'get_page' 两个工具供 LLM 调用。
diff-server:
- 支持生成两个文件版本之间的差异文件 (diff)。
- 提供了 'generate_diff' 工具，允许 LLM 调用以生成文件差异。

安装步骤

克隆仓库：将 GitHub 仓库克隆到本地。

git clone https://github.com/gxjansen/MCP.git
cd MCP

进入服务器目录：选择你想要使用的服务器，例如 'astro-docs-server' 或 'diff-server'，并进入相应的目录。
```
cd astro-docs-server  # 或 cd diff-server
```
安装依赖：使用 npm 安装项目依赖。
```
npm install
```
构建服务器：构建 TypeScript 代码为 JavaScript。
```
npm run build
```

服务器配置

要将这些 MCP 服务器与 MCP 客户端（如 Cline）一起使用，需要在客户端的 MCP 设置文件中进行配置。以下是配置示例，你需要根据实际情况修改文件路径。

astro-docs-server 配置示例：

{
  "mcpServers": {
    "astro-docs": {  // 服务器名称，可以自定义
      "command": "node", // 运行服务器的命令，这里使用 Node.js
      "args": ["/path/to/MCP/astro-docs-server/build/index.js"] // 服务器启动参数，指向构建后的 index.js 文件
      // 请将 "/path/to/MCP" 替换为 MCP 仓库在您本地的实际路径
    }
  }
}

diff-server 配置示例：

{
  "mcpServers": {
    "diff-server": {  // 服务器名称，可以自定义
      "command": "node", // 运行服务器的命令，这里使用 Node.js
      "args": ["/path/to/MCP/diff-server/build/index.js"] // 服务器启动参数，指向构建后的 index.js 文件
      // 请将 "/path/to/MCP" 替换为 MCP 仓库在您本地的实际路径
    }
  }
}

配置路径参考 (根据 README.md 提供的信息)：

VSCodium: '/Users/gxjansen/Library/Application Support/VSCodium/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json'
Claude Desktop: '~/Library/Application Support/Claude/claude_desktop_config.json'

注意: 请根据你的 MCP 客户端的实际配置文件路径进行配置。

基本使用方法

启动服务器：配置完成后，当 MCP 客户端需要使用这些服务器的功能时，客户端会自动启动配置的 MCP 服务器。服务器将在后台运行，并通过标准输入/输出 (stdio) 与客户端通信。
通过客户端调用工具：在 MCP 客户端中，你可以指示 LLM 使用已配置的工具。例如，如果你想搜索 Astro 文档，你可以告诉 LLM “使用 'search_docs' 工具搜索 Astro 文档关于组件的内容”。客户端会将请求转发给 'astro-docs-server'，服务器会执行搜索并将结果返回给客户端，最终呈现给用户。
工具的具体使用：
- 'astro-docs-server' 的 'search_docs' 工具需要 'query' 参数（搜索关键词），可选参数 'max_results'（最大结果数）。'get_page' 工具需要 'path' 参数（文档页面路径）。
- 'diff-server' 的 'generate_diff' 工具需要 'oldFilePath'（旧文件路径）、'newFilePath'（新文件路径）和 'outputFilePath'（差异文件输出路径）参数。

具体如何通过自然语言或客户端界面调用这些工具，请参考你使用的 MCP 客户端的文档。

关键词