使用说明
MCP工具包
CLI工具,用于为VS Code、Cursor、Windsurf和Zed编辑器配置MCP(模型上下文协议)服务器。
快速开始
make build && ./bin/mcp-toolkit quickstart
需求
- 转到1.23+
- 容器运行时(可选):Docker、Podman或Rancher Desktop
- 小曼巴(用于发展)
安装
make build # Build for current platform
make build-all # Build for all platforms
make install # Install to GOPATH/bin
用法
mcp-toolkit quickstart # Interactive setup for all servers
mcp-toolkit quickstart --all # Configure all servers without prompts
mcp-toolkit setup atlassian # Setup specific server
mcp-toolkit env # Show environment variables
mcp-toolkit version # Show version
支持的服务器
| 服务器 | 容器 | 描述 |
|---|---|---|
| atlassian | mcp/atlassian | Jira和Confluence集成 |
| kubernetes | mcp/kubernetes | K8s集群管理 |
| vault | 本地二进制文件 | HashiCorp vault机密 |
| github | - | github Copilot(内置) |
| supabase | - | supabase数据库(托管) |
支持的编辑器
| 编辑器 | 配置位置 |
|---|---|
| VS代码 | ~/Library/Application Support/Code/User/mcp.json (macOS) |
| 光标 | ~/Library/Application Support/Cursor/User/mcp.json (macOS) |
| 风帆冲浪 | ~/Library/Application Support/Windsurf/User/mcp.json (macOS) |
| Zed | ~/.config/zed/settings.json |
发展
# Setup environment
micromamba create -f environment.yml
micromamba activate mcp-toolkit
# Development commands
make lint # Format and vet code
make test # Run unit tests
make test-cover # Run tests with coverage
make coverage-check # Verify 90% coverage threshold
make ci # Full CI pipeline
make pre-commit # Run pre-commit hooks
项目结构
cmd/mcp-toolkit/ # CLI entry point
internal/
cli/ # Cobra commands (quickstart, setup, env, version)
config/ # Paths and mcp.json generation
container/ # Docker/Podman/Rancher runtime detection
editor/ # Multi-editor support with OS-specific paths
envvar/ # Environment variable management
prompt/ # Interactive terminal input
setup/ # Server configuration writers
make/ # Modular Makefile includes
test/e2e/ # End-to-end tests
配置
| 类型 | 位置 |
|---|---|
| 证书 | ~/.mcp-server-envs/*.env (0700权限) |
| 编辑器配置 | 特定于操作系统和编辑器 mcp.json |
环境变量
所有配置都可以通过环境变量进行设置 MCP_ 前缀:
MCP_ATLASSIAN_URL=https://company.atlassian.net
MCP_ATLASSIAN_EMAIL=user@example.com
MCP_ATLASSIAN_API_TOKEN=secret
MCP_VAULT_ADDRESS=https://vault.example.com
跑 mcp-toolkit env 查看所有可用变量。
许可证
麻省理工学院
