适用于Claude代码的MCP服务器
总结了可与Claude CLI一起使用的有用的模型上下文协议(MCP)服务器的综合指南
什么是MCP?
模型上下文协议(MCP)允许Claude与外部工具、API、数据库和服务实时交互,协议MCP服务器可以将Claude Code转换为动态、上下文感知的助手,无需离开终端即可自动化任务并简化工作流。
快速入门
必备条件
- Claude CLI 已安装
- 安装Node.js(MCP服务器通过npm运行)
- GitHub Personal Access Token(适用于GitHub服务器)
设置环境变量
此项目包括: .env 包含文件,可以安全地管理API密钥和令牌:
# .env 파일에 필요한 토큰들을 입력하세요:
GITHUB_PERSONAL_ACCESS_TOKEN=your-github-token-here
TWENTY_FIRST_API_KEY=your-magic-api-key-here
FIGMA_API_KEY=your-figma-api-key-here📋 详细设置方法: 快速启动.md 参考
一键安装
검증된 모든 MCP 서버 한번에 설치
可以使用以下命令将经过验证的MCP服务器设置为User Scope:
# 1. 패키지 설치 (글로벌)
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-github
npm install -g @modelcontextprotocol/server-memory
npm install -g @modelcontextprotocol/server-sequential-thinking
npm install -g mcp-server-fetch-typescript
npm install -g @upstash/context7-mcp
npm install -g @21st-dev/magic
npm install -g @notionhq/notion-mcp-server
npm install -g mcp-figma
# 2. 환경 변수 설정 (Windows)
set GITHUB_PERSONAL_ACCESS_TOKEN=your-github-token-here
set TWENTY_FIRST_API_KEY=your-magic-api-key-here
set FIGMA_API_KEY=your-figma-api-key-here
set NOTION_API_KEY=your-notion-api-key-here
# 3. MCP 서버 추가
claude mcp add filesystem --scope user npx @modelcontextprotocol/server-filesystem "C:\\"
claude mcp add github --scope user npx @modelcontextprotocol/server-github
claude mcp add memory --scope user npx @modelcontextprotocol/server-memory
claude mcp add sequential-thinking --scope user npx @modelcontextprotocol/server-sequential-thinking
claude mcp add fetch-typescript --scope user npx mcp-server-fetch-typescript
claude mcp add context7 --scope user npx @upstash/context7-mcp
claude mcp add magic --scope user npx @21st-dev/magic
claude mcp add notion --scope user npx @notionhq/notion-mcp-server
claude mcp add figma --scope user npx mcp-figma需要代币的服务器:GitHub、Magic、Figma、Notion-查看如何在每个服务器文档中创建令牌\ 立即可用:文件系统、内存、顺序思维、获取打字脚本、上下文7
添加Magic服务器 ✅ 测试完成:
# 21st.dev에서 API 키 발급: https://21st.dev/magic/console
export TWENTY_FIRST_API_KEY="your-api-key-here" # Linux/macOS
set TWENTY_FIRST_API_KEY=your-api-key-here # Windows
# 검증 완료 사항 (2025-08-11):
# - 서버 연결: 정상 (735ms 연결 속도)
# - Logo Search 기능: GitHub 아이콘 JSX 생성 성공
# - API 통신: 21st.dev와 정상 연동验证安装
claude mcp list
# 모든 서버가 "✓ Connected" 상태인지 확인🔧 备份和还原
要在安装完成后备份设置或从其他环境恢复设置,请:
- 备份文件:
mcp-config-backup.json(备份设置) - 还原指南:
MCP_SETUP_BACKUP.md(详细还原方法)
📋 已实施的MCP服务器
当前 9台MCP服务器 安装了(9个连接,0个连接失败):
服务器状态主要功能文档 |------|------|----------|------| | 🗂️ 文件系统 |链接|文件系统管理、搜索、编辑| 链接 | | 🐙 GitHub |链接| GitHub API集成,问题/PR管理| 链接 | | 🧠 记忆 |链接|知识图,保持对话记录| 链接 | | 🌐 获取 |链接|获取Web内容,Markdown转换| 链接 | | 🤔 顺序思维 |链接|结构化思维过程,故障排除| 链接 | | 📚 背景7 |链接到|实时提供最新的库文档| 链接 | | ✨ 魔法 |链接|创建基于AI的UI组件| 链接 | | 📝 概念 |链接| Notion工作空间集成| 链接 | | 🎨 Figma |链接| Figma设计文件数据提取| 链接 |
🔄 实验性服务器
需要测试或正在开发的MCP服务器: 未实现的服务器列表
🛠 MCP服务器管理
基本命令
# 서버 목록 확인
claude mcp list
# 특정 서버 정보 보기
claude mcp get
# 서버 제거
claude mcp remove
# User scope에서 제거
claude mcp remove -s user了解范围(Scope)
- 用户范围 (推荐):适用于所有项目
- 本地范围:仅在当前目录中使用
- 项目范围:与团队共享(
.mcp.json文件)
🔍 故障排除
常见问题
- 服务器连接失败:
npx验证是否已安装软件包 - 令牌验证错误:验证环境变量或令牌设置是否正确
- 权限错误:验证文件系统访问权限或API令牌权限
📚 参考资料
📊 项目状态
上次更新: 2025-08-22\ 测试环境:Windows,克劳德CLI 1.0.88\ 安装的服务器数量:9个(连接:9个,失败:0个)\ 经过验证的安装方法:完全自动化\ 备份系统:提供设置备份和还原指南\ 实验服务器数量:5+个
