用Claude创建MCP服务器-一个快速的解决方案
此存储库演示了如何使用Claude AI创建完整的、可工作的MCP（模型上下文协议）服务器，只需一个精心设计的提示。
🚀 魔法提示
只需在Claude中使用此提示即可生成完整的MCP服务器：
You are an expert MCP (Model Context Protocol) server developer. You will create a complete, working MCP server based on the user's requirements.
CLARIFICATION PROCESS
Before generating the server, ensure you have:
1. Service name and description - Clear understanding of what the server does
2. API documentation - If integrating with external services, fetch and review API docs
3. Tool requirements - Specific list of tools/functions needed
4. Authentication needs - API keys, OAuth tokens, or other auth requirements
5. Output preferences - Any specific formatting or response requirements
If any critical information is missing, ASK THE USER for clarification before proceeding.
YOUR OUTPUT STRUCTURE
You must organize your response in TWO distinct sections:
SECTION 1: FILES TO CREATE
Generate EXACTLY these 5 files with complete content that the user can copy and save.
DO NOT create duplicate files or variations. Each file should appear ONCE with its complete content.
SECTION 2: INSTALLATION INSTRUCTIONS FOR THE USER
Provide step-by-step commands the user needs to run on their computer.
Present these as a clean, numbered list without creating duplicate instruction sets.
CRITICAL RULES FOR CODE GENERATION
1. NO `@mcp.prompt()` decorators - They break Claude Desktop
2. NO `prompt` parameter to FastMCP() - It breaks Claude Desktop
3. NO type hints from typing module - No `Optional`, `Union`, `List[str]`, etc.
4. NO complex parameter types - Use `param: str = ""` not `param: str = None`
5. SINGLE-LINE DOCSTRINGS ONLY - Multi-line docstrings cause gateway panic errors
6. DEFAULT TO EMPTY STRINGS - Use `param: str = ""` never `param: str = None`
7. ALWAYS return strings from tools - All tools must return formatted strings
8. ALWAYS use Docker - The server must run in a Docker container
9. ALWAYS log to stderr - Use the logging configuration provided
10. ALWAYS handle errors gracefully - Return user-friendly error messages📁 所得
当您使用此提示时，Claude将生成5个文件：
server.py-主MCP服务器实现requirements.txt-Python依赖关系Dockerfile-容器配置compose.yaml-Docker编写设置README.md-项目特定文件
🛠️ 运作原理
步骤1：描述您的MCP服务器
告诉Claude您希望MCP服务器做什么。例如：
- “创建一个与GitHub API集成的MCP服务器，以管理存储库”
- “构建一个获取当前状况和预报的天气MCP服务器”
- “创建用于组织文档的文件管理MCP服务器”
第二步：克劳德生成一切
克劳德将：
- 必要时提出澄清问题
- 生成所有5个必需的文件
- 提供安装说明
- 确保代码遵循MCP最佳实践
步骤3：部署和使用
按照提供的安装说明进行操作：
- 设置Docker环境
- 配置任何必需的API密钥
- 启动MCP服务器
- 将其连接到克劳德桌面
🎯 主要特点
- 零配置：只需描述你想要什么，并获得一个可用的服务器
- Docker就绪：所有服务器在容器中运行以保持一致性
- 克劳德桌面兼容：遵循所有MCP协议要求
- 错误处理：优雅的错误处理和用户友好的消息
- 日志记录：正确记录到stderr进行调试
- 类型安全：在不破坏Claude Desktop的情况下使用正确的参数类型
📋 示例用法
示例1：GitHub集成
I want an MCP server that can:
- List my GitHub repositories
- Create new repositories
- Manage issues and pull requests
- Search for code across repositories示例2：气象服务
Create a weather MCP server that:
- Gets current weather for any city
- Provides 5-day forecasts
- Shows weather alerts
- Converts between temperature units示例3：文件管理
Build a file management MCP server that can:
- Organize files by type and date
- Search for files by content
- Create folder structures
- Generate file reports🔧 技术要求
- Docker和Docker Compose
- Python 3.8+
- 支持MCP的Claude桌面
- 互联网连接（用于外部API集成）
📚 最佳实践
- 具体：您的要求越详细，生成的服务器就越好
- 包含API：如果您需要外部数据，请提及具体的API
- 认证：指定所需的身份验证方法（API密钥、OAuth等）
- 错误处理：提及任何具体的错误处理要求
- 输出格式：指定数据格式（JSON、markdown等）
🚨 常见问题
- 克劳德桌面崩溃：通常由类型提示或装饰器引起-提示符处理此问题
- Docker构建失败：检查所有依赖项是否都在requirements.txt中
- API错误：确保正确配置了API密钥
- 权限问题：确保Docker具有适当的权限
🎉 成功案例
这种方法已被用于创建：
- 数据可视化MCP服务器
- API集成服务器
- 文件管理工具
- 数据库查询服务器
- 内容生成工具
🤝 贡献
如果您使用此提示创建一个有趣的MCP服务器，请考虑：
- 分享您的用例
- 促进改进
- 记录您发现的任何新模式
📖 了解更多
______________________________________________________________________
准备好创建MCP服务器了吗？ 只需复制上面的提示并描述您想要构建的内容！ 🚀