MCP 服务器配置

什么是 MCP？

MCP (Model Context Protocol) 是 Anthropic 开源的协议，让 AI 助手能够调用外部工具和服务。通过配置 MCP 服务器，你可以扩展 AI 的能力。

MCP Servers Overview

Essential Servers (No API Keys Required)

Peekaboo - Screenshots. Works without AI, better with OpenAI key
Context7 - Fetches current docs for any library
Agent - Run Claude Code as a sub-agent
Automator - macOS automation
GitMCP - Enhanced Git with visual diffs (SSE transport)
Playwright - Browser automation

Servers Requiring API Keys

GitHub - Needs GITHUB_PERSONAL_ACCESS_TOKEN in ~/.zshrc
Firecrawl - Needs FIRECRAWL_API_KEY for web scraping

Prerequisites

# Check/install required tools
command -v jq || brew install jq
command -v node || echo "Need Node.js 20+"
command -v ollama || brew install ollama

# Check API keys in ~/.zshrc
grep "OPENAI_API_KEY\|GITHUB_PERSONAL_ACCESS_TOKEN\|FIRECRAWL_API_KEY" ~/.zshrc

Installation for Claude Code

# Essential servers (work immediately)
claude mcp add-json -s user peekaboo '{"command": "npx", "args": ["-y", "@steipete/peekaboo-mcp@beta"]}'
claude mcp add-json -s user context7 '{"command": "npx", "args": ["-y", "@upstash/context7-mcp@latest"]}'
claude mcp add-json -s user agent '{"command": "npx", "args": ["-y", "@steipete/claude-code-mcp@latest"]}'
claude mcp add-json -s user automator '{"command": "npx", "args": ["-y", "@steipete/macos-automator-mcp@latest"], "env": {"LOG_LEVEL": "INFO"}}'
claude mcp add-json -s user playwright '{"command": "npx", "args": ["@playwright/mcp@latest"]}'
claude mcp add -s user -t sse gitmcp https://gitmcp.io/docs

# With API keys (check ~/.zshrc first)
claude mcp add-json -s user github '{"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."}}'
claude mcp add-json -s user firecrawl-mcp '{"command": "npx", "args": ["-y", "firecrawl-mcp"], "env": {"FIRECRAWL_API_KEY": "fc-..."}}'

Installation for Claude Desktop

Claude Desktop only supports stdio transport. Create or update ~/Library/Application Support/Claude/claude_desktop_config.json:

{
	"mcpServers": {
		"peekaboo": {
			"command": "npx",
			"args": ["-y", "@steipete/peekaboo-mcp@beta"],
			"env": {
				"PEEKABOO_AI_PROVIDERS": "openai/gpt-4o,ollama/llava:latest",
				"OPENAI_API_KEY": "sk-..."
			}
		},
		"context7": {
			"command": "npx",
			"args": ["-y", "@upstash/context7-mcp@latest"]
		},
		"agent": {
			"command": "npx",
			"args": ["-y", "@steipete/claude-code-mcp@latest"]
		},
		"automator": {
			"command": "npx",
			"args": ["-y", "@steipete/macos-automator-mcp@latest"],
			"env": { "LOG_LEVEL": "INFO" }
		},
		"playwright": {
			"command": "npx",
			"args": ["@playwright/mcp@latest"]
		}
	}
}

Note: Claude Desktop cannot use GitMCP (SSE) or GitHub with HTTP transport.

Installation for Cursor

Create or update ~/.cursor/mcp.json:

{
	"mcpServers": {
		"peekaboo": {
			"command": "npx",
			"args": ["-y", "@steipete/peekaboo-mcp@beta"],
			"env": {
				"PEEKABOO_AI_PROVIDERS": "openai/gpt-4o,ollama/llava:latest",
				"OPENAI_API_KEY": "sk-..."
			}
		},
		"context7": {
			"command": "npx",
			"args": ["-y", "@upstash/context7-mcp@latest"]
		},
		"gitmcp": {
			"transport": "sse",
			"url": "https://gitmcp.io/docs"
		}
	}
}

Installation for Windsurf

Create or update ~/.codeium/windsurf/mcp_config.json with the same format as Cursor.

Installation for VS Code

Update ~/Library/Application Support/Code/User/settings.json:

{
	"mcp.servers": {
		"peekaboo": {
			"command": "npx",
			"args": ["-y", "@steipete/peekaboo-mcp@beta"]
		}
	}
}

Note: VS Code uses mcp.servers not mcpServers.

API Key Setup

Add to ~/.zshrc:

export OPENAI_API_KEY="sk-..."              # For Peekaboo AI vision
export GITHUB_PERSONAL_ACCESS_TOKEN="ghp-..." # For GitHub MCP (needs repo scope)
export FIRECRAWL_API_KEY="fc-..."           # For Firecrawl

Then run source ~/.zshrc

Common Issues

JSON errors: Use proper quotes in JSON commands
Claude Desktop: Only supports stdio (no SSE/HTTP)
Permissions: Grant Screen Recording for Peekaboo
Restart required: After config changes

Tips

Use -s user flag to install servers globally in Claude Code
API keys should be in ~/.zshrc, not hardcoded
Always extract keys from environment variables
Ensure local paths exist before adding (e.g., Obsidian MCP server)

Terminal Title Trick

When running multiple Claude Code instances, it's hard to know which terminal is working on which project. Add this cly function to your ~/.zshrc:

cly () {
    local folder=${PWD:t}
    echo -ne "\033]0;$folder — Claude\007"  # Set terminal title
    "$HOME/.claude/local/claude" --dangerously-skip-permissions "$@"
    local exit_code=$?
    echo -ne "\033]0;%~\007"  # Restore title
    return $exit_code
}

Usage: Instead of typing claude, type cly to start Claude Code with dynamic terminal titles.

下一步

配置好 MCP 服务器后，建议学习 MCP 配置同步来管理跨平台的配置。

MCP 服务器配置

注册解锁完整内容