🚀 代码空间开发环境
具有MCP服务器和Gemini CLI的单存储库VSCode开发环境,针对GitHub Codespace免费层进行了优化。
⚡ 快速开始
- 创建代码空间 来自此存储库
- 添加API密钥 代码空间机密:
- GEMINI_API_KEY:从 谷歌人工智能工作室
- 等待设置 (通过devcontainer自动)
- 开始编码 在AI的帮助下!
🛠️ 包含什么
核心环境
- VSCode 具有优化的设置
- Node.js LTS + Python 3.11
- 基本扩展 (自动安装)
人工智能集成
- Gemini CLI 免费AI协助
- MCP服务器 用于工具集成
- GitHub集成 用于存储库管理
开发工具
- 文件 操作 通过MCP文件系统服务器
- Git配置 存在合理的违约
- 端口转发 用于web开发(300080005173)
🤖 使用Gemini CLI
# Basic AI assistance
gemini "Explain this code: $(cat script.py)"
# Code generation
gemini "Create a React component for a todo list"
# Debug help
gemini "Why is this function not working: $(cat debug.js)"🔌 MCP服务器
模型上下文协议服务器为AI提供了工具功能:
- 文件系统:读/写文件、目录操作
- GitHub:存储库管理、问题跟踪
# Test MCP setup
bash scripts/mcp-test.sh
# List available tools
mcp list-tools --all⚙️ 配置
需要GitHub机密
GEMINI_API_KEY:Google AI Studio API密钥GITHUB_TOKEN:由代码空间自动提供
VS代码设置
- 自动保存已启用
- 保存时格式化
- 针对生产力进行了优化
📁 项目结构
codespace-dev-env/
├── .devcontainer/ # Codespace configuration
│ ├── devcontainer.json # Container settings
│ └── setup.sh # Auto-setup script
├── .vscode/ # VSCode configuration
│ ├── settings.json # Editor settings
│ └── extensions.json # Recommended extensions
├── .config/ # Tool configurations
│ └── mcp-config.json # MCP server settings
├── scripts/ # Utility scripts
│ ├── gemini-setup.sh # Gemini CLI setup
│ └── mcp-test.sh # MCP server testing
└── README.md # This file🎯 设计原则
- 速度:2分钟设置,而复杂的替代方案需要30多分钟
- 简洁:一个存储库,最低配置
- 成本有效:免费套餐优化(双子座vs付费副驾驶)
- 可扩展:易于添加工具和配置
🚀 后续步骤
环境准备就绪后:
- 测试AI集成:
bash scripts/gemini-setup.sh - 验证MCP服务器:
bash scripts/mcp-test.sh - 开始你的项目 在工作空间中
- 定制 根据需要进行设置
🔄 扩展此环境
此MVP可以通过以下方式增强:
- 附加MCP服务器(自定义工具)
- 云存储集成(rclone)
- 高级凭证管理
- 自定义VSCode扩展
- 项目特定模板
______________________________________________________________________
总设置时间:约2分钟\ 资源使用情况:最低(免费层友好)\ 维护:低(单一存储库)
基于Clear Thought分析构建,可实现最佳的开发人员生产力。
