适用于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密钥和令牌:```bash
.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:```bash
# 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服务器 ✅ 测试完成:```bash
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와 정상 연동
### 验证安装```bash
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服务器管理
基本命令```bash
서버 목록 확인
claude mcp list
특정 서버 정보 보기
claude mcp get <서버이름>
서버 제거
claude mcp remove <서버이름>
User scope에서 제거
claude mcp remove <서버이름> -s user
```
了解范围(Scope)
- 用户范围 (推荐):适用于所有项目
- 本地范围:仅在当前目录中使用
- 项目范围:与团队共享(
.mcp.json文件)
🔍 故障排除
常见问题
- 服务器连接失败:
npx验证是否已安装软件包 - 令牌验证错误:验证环境变量或令牌设置是否正确
- 权限错误:验证文件系统访问权限或API令牌权限
📚 参考资料
- Claude Code MCP官方文件
📊 项目状态
上次更新: 2025-08-22\
测试环境:Windows,克劳德CLI 1.0.88\
安装的服务器数量:9个(连接:9个,失败:0个)\
经过验证的安装方法:完全自动化\
备份系统:提供设置备份和还原指南\
实验服务器数量:5+个
