🚀 如何运行基于 VS Code 的 Peacock MCP 服务器

本项目旨在帮助你在 VS Code 中运行 Peacock MCP 服务器，并在 GitHub Copilot 中使用其功能。通过以下步骤，你可以轻松完成服务器的配置和使用。

🚀 快速开始

发现现有 MCP 服务器

如果你已经启用了由 Claude Desktop 提供支持的 MCP 服务器，可在 VS Code 设置中添加 chat.mcp.discovery.enabled: true，这样它将发现现有的 MCP 服务器列表。

将 MCP 服务器与特定仓库关联

在该仓库目录下创建 .vscode/mcp.json 文件，并添加以下内容：

{
  "inputs": [],
  "servers": {
    "peacock-mcp": {
      "command": "npx",
      // "command": "node",
      "args": [
        "-y",
        "@johnpapa/peacock-mcp"
        // "_git/peacock-mcp/dist/index.js"
      ],
      "env": {}
    }
  }
}

将 MCP 服务器与所有仓库关联

在 VS Code 用户设置 JSON 中添加以下内容：

"mcp": {
  "servers": {
    "peacock-mcp": {
      "command": "npx",
      // "command": "node",
      "args": [
        "-y",
        "@johnpapa/peacock-mcp"
        // "/Users/papa/_git/peacock-mcp/dist/index.js"
        // "_git/peacock-mcp/dist/index.js"
      ],
      "env": {}
    }
  }
}
"chat.mcp.discovery.enabled": true,

📦 安装指南

使用 VS Code 手动安装

⚠️ 重要提示

如果要快速安装，请点击本 README 顶部的安装按钮。

使用 VS Code 设置

要在 VS Code 中手动安装 Peacock MCP 服务器，请按照以下步骤操作：

1. 打开 VS Code 设置（JSON）：按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux），搜索“Preferences: Open User Settings (JSON)”。
2. 将以下 JSON 添加到你的设置文件中：

{
  "mcp": {
    "servers": {
      "peacock-mcp": {
        "command": "npx",
        "args": ["-y", "@johnpapa/peacock-mcp"],
        "env": {}
      }
    }
  },
  "chat.mcp.discovery.enabled": true
}

使用 CLI 命令

• 对于 VS Code 稳定版本：

code --add-mcp '{"name":"peacock-mcp","command":"npx","args":["-y","@johnpapa/peacock-mcp"],"env":{}}'

• 对于 VS Code Insiders 版本：

code-insiders --add-mcp '{"name":"peacock-mcp","command":"npx","args":["-y","@johnpapa/peacock-mcp"],"env":{}}'

使用 Smithery 安装

要通过 Smithery 自动安装 Peacock MCP 服务器以供 Claude Desktop 使用，请运行以下命令：

npx -y @smithery/cli install @johnpapa/peacock-mcp --client claude

在本地使用 MCP Inspector 运行

如果想通过 MCP Inspector 本地运行服务器以进行测试，请按照以下步骤操作：

1. 克隆此仓库：

git clone https://github.com/johnpapa/peacock-mcp

2. 安装所需的依赖项并构建项目：

npm install
npm run build

3. （可选）要尝试使用 MCP Inspector 运行服务器，请运行以下命令：

# 启动 MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js

在浏览器中访问控制台中显示的 MCP Inspector URL。将 Arguments 更改为 dist/index.js，然后选择 Connect。选择 List Tools 查看所有可用工具。

💻 使用示例

使用 GitHub Copilot 中的工具

1. 现在 MCP 服务器已可发现，请打开 GitHub Copilot 并选择 Agent 模式（不是 Chat 或 Edits）。
2. 在 Copilot 聊天文本字段中选择“刷新”按钮以刷新服务器列表。
3. 选择“🛠️”按钮以查看所有可能的工具，包括此仓库中的工具。
4. 提一个问题，该问题会自然调用其中一个工具，例如：

如何设置我的 VS Code 调色板颜色？

⚠️ 重要提示

如果看到“抱歉，响应被负责任的人工智能服务过滤了。请重新措辞并重试。”，请再次运行或重新措辞问题。

通过这些步骤，你可以在 VS Code 中成功运行 Peacock MCP 服务器，并在 GitHub Copilot 中使用其功能。