MCP Server for the Peacock extension for VS Code, coloring your world, one Code editor at a time. The main goal of the project is to show how an MCP server can be used to interact with APIs.
Note: All data used by this MCP server is fetched from the official Peacock documentation.
🔧 Features
- Fetch Peacock docs: Get detailed info on Peacock.
🧰 Tools
1. fetch_peacock_docs 🔍🦸♂️
- Description: Fetches the Peacock for VS Code extension docs from its GitHub repository and answers questions based on the documentation
- Input:
prompt(query): The question about Peacock.
- Returns: Your answer!
🛠️ Setup
Install Peacock for VS Code HERE.
Running the MCP Server hosted in GitHub Copilot with VS Code Insiders
Note: If you already have the MCP server enabled with Claude Desktop, add
chat.mcp.discovery.enabled: truein your VS Code settings and it will discover existing MCP server lists.
If you want to associate the MCP server with a specific repo, create a .vscode/mcp.json file with this content:
{
"inputs": [],
"servers": {
"peacock-mcp": {
"command": "npx",
// "command": "node",
"args": [
"-y",
"@johnpapa/peacock-mcp"
// "_git/peacock-mcp/dist/index.js"
],
"env": {}
}
}
}
If you want to associate the MCP server with all repos, add the following to your VS Code User Settings 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 Manual Installation
Note: For quick installation, click the install buttons at the top of this README.
Using VS Code Settings
To manually install the Peacock MCP server in VS Code, follow these steps:
- Open VS Code Settings (JSON) by pressing
Cmd+Shift+P(macOS) orCtrl+Shift+P(Windows/Linux) and searching for "Preferences: Open User Settings (JSON)" - Add the following JSON to your settings file:
{
"mcp": {
"servers": {
"peacock-mcp": {
"command": "npx",
"args": ["-y", "@johnpapa/peacock-mcp"],
"env": {}
}
}
},
"chat.mcp.discovery.enabled": true
}
Using CLI Commands
For VS Code Stable:
code --add-mcp '{"name":"peacock-mcp","command":"npx","args":["-y","@johnpapa/peacock-mcp"],"env":{}}'
For VS Code Insiders:
code-insiders --add-mcp '{"name":"peacock-mcp","command":"npx","args":["-y","@johnpapa/peacock-mcp"],"env":{}}'
Installing via Smithery
To install Peacock MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @johnpapa/peacock-mcp --client claude
Run the MCP Server Locally with MCP Inspector
If you'd like to run MCP Inspector locally to test the server, follow these steps:
-
Clone this repository:
git clone https://github.com/johnpapa/peacock-mcp -
Install the required dependencies and build the project.
npm install npm run build -
(Optional) To try out the server using MCP Inspector run the following command:
# Start the MCP Inspector npx @modelcontextprotocol/inspector node build/index.jsVisit the MCP Inspector URL shown in the console in your browser. Change
Argumentstodist/index.jsand selectConnect. SelectList Toolsto see the available tools.
Using Tools in GitHub Copilot
-
Now that the mcp server is discoverable, open GitHub Copilot and select the
Agentmode (notChatorEdits). -
Select the "refresh" button in the Copilot chat text field to refresh the server list.
-
Select the "🛠️" button to see all the possible tools, including the ones from this repo.
-
Put a question in the chat that would naturally invoke one of the tools, for example:
How do I set my VS Code accent colors?Note: If you see "Sorry, the response was filtered by the Responsible AI Service. Please rephrase your prompt and try again.", try running it again or rephrasing the prompt.