代码空间开发环境

一个基于GitHub Codespaces的VSCode开发环境,集成了Gemini CLI和MCP服务器,提供AI辅助编程和工具集成功能。

  • by odenizo
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 odenizo/codespace-dev-env

使用说明

🚀 代码空间开发环境

具有MCP服务器和Gemini CLI的单存储库VSCode开发环境,针对GitHub Codespace免费层进行了优化。

⚡ 快速开始

  1. 创建代码空间 来自此存储库
  2. 添加API密钥 代码空间机密:
  3. 等待设置 (通过devcontainer自动)
  4. 开始编码 在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付费副驾驶)
  • 可扩展:易于添加工具和配置

🚀 后续步骤

环境准备就绪后:

  1. 测试AI集成: bash scripts/gemini-setup.sh
  2. 验证MCP服务器: bash scripts/mcp-test.sh
  3. 开始你的项目 在工作空间中
  4. 定制 根据需要进行设置

🔄 扩展此环境

此MVP可以通过以下方式增强:

  • 附加MCP服务器(自定义工具)
  • 云存储集成(rclone)
  • 高级凭证管理
  • 自定义VSCode扩展
  • 项目特定模板

总设置时间:约2分钟
资源使用情况:最低(免费层友好)
维护:低(单一存储库)

基于Clear Thought分析构建,可实现最佳的开发人员生产力。