AI导哈

开发任务游戏化工具

Codex MCP是一款AI驱动的开发任务游戏化工具，通过将开发任务分解为具体步骤、跟踪进度并奖励XP来提升开发效率。适用于软件开发、代码优化和团队协作等场景。

  • by AIckathon-2025-08
  • Ruby
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 AIckathon-2025-08/codex-mcp

使用说明

🎮 食品法典委员会MCP

通过AI驱动的故障和XP进度将您的开发任务转化为任务

描述

这是什么？

Codex是一个MCP服务器，它将您的开发工作游戏化。告诉AI Agent您需要做什么，Codex会将其分解为具体步骤，跟踪您的进度，并在您完成目标时奖励XP。

它是如何工作的：

You → AI Agent → Codex (state management) → AI Agent → You
         ↓         ↓                          ↓
      Thinking  Stores tasks,              Presents
                tracks XP                   results

AI Agent负责所有的思考。Codex处理状态持久性和编排。简单、快速、可维护。

主要特点： 叙述者可以是你的人工智能知道的任何角色——GLaDOS、甘道夫、里克·桑切斯，或者创建你自己的角色！

如何使用

基本用法

你： “我需要优化数据库查询。仪表板需要8秒。”

人工智能代理（通过食品法典委员会）：

“让我把它分解一下。几个问题：

  • 哪些特定查询速度较慢？
  • 数据量是多少？
  • 当前数据库结构？"

你： “用户仪表板端点。每个用户50k个订单。没有分页或索引。”

AI代理：

“明白了！这是你的任务：

🎯 目标：

  1. ☐ 使用EXPLAIN ANALYZE进行配置文件查询
  2. ☐ 在user_id和created_at上添加数据库索引
  3. ☐ 实现分页（每页20个）
  4. ☐ 通过快速加载优化N+1查询
  5. ☐ 添加Redis缓存层
  6. ☐ 使用50k+订单用户进行测试

从分析开始！"

[你通过目标工作，每个目标获得+25经验值]

你： “全部完成！仪表板现在将在0.5秒内加载。”

AI代理：

"🎉 任务完成！

性能：8秒→ 0.5s（快16倍！） 获得经验值：+270（目标150+奖励120） 升级！ 你现在是3级！

准备好迎接下一个挑战了吗？"

GLaDOS旁白示例

设置叙述者：

你： “将我的叙述者设置为《传送门》中的GLaDOS。讽刺一下。”

AI代理： [更新叙述者声音]

你： “我需要为支付系统编写单元测试。”

格拉多斯：

“哦，太棒了。单元测试。因为很明显，比编写代码更好的唯一方法就是编写更多的代码来验证它是否有效。这是你的测试室：

  1. ☐ 测试快乐路径支付处理
  2. ☐ 付款测试失败
  3. ☐ 测试退款
  4. ☐ 测试边缘情况（零数量，负数）
  5. ☐ 测试并发付款

尽量不要打碎任何东西。那将是一种耻辱。"

[完成第一个目标后]

格拉多斯：

“好吧。你设法在不破坏一切的情况下完成了一次测试。+25 XP。怎么……足够了。还有四次。”

[任务完成后]

格拉多斯：

“恭喜你。尽管困难重重，你已经编写了一个完整的测试套件。支付系统现在已经‘经过适当测试’。总共增加了175 XP。你已经升级到4级。我和你一样惊讶。"

可用命令

与AI Agent自然对话：

开始任务：

  • “我需要重构身份验证系统”
  • “帮助我优化此缓慢的API终结点”
  • “我必须为用户配置文件添加一个新功能”

跟踪进度：

  • “显示我的任务进度”
  • “我目前的级别和XP是多少？”
  • “列出我的活动任务”

自定义叙述者：

  • “将我的叙述者设置为《指环王》中的甘道夫”
  • “将叙述者改为教官”
  • “让叙述者成为一只热情的金毛猎犬”
  • “将叙述者设置为里克·桑切斯——愤世嫉俗，偶尔打嗝”

完成工作：

  • “我完成了对查询的分析”
  • “已完成添加索引”
  • “所有目标完成！”

记得： 叙述者可以是任何角色——历史人物、虚构人物、原型或完全原创的人物。发挥创意！

安装

先决条件

  • Docker&Docker编写
  • Claude Desktop或Claude Code或任何其他支持MCP的AI代理
  • 5分钟

设置

# 1. Clone repository
git clone https://github.com/yourusername/codex-mcp.git
cd codex-mcp

# 2. Start Codex server (runs in background)
./setup.sh

# 3. Configure your AI Agent client (see below)

# 4. Restart AI Agent client and start questing!

适用于克劳德桌面

https://docs.anthropic.com/en/docs/build-with-claude/mcp

编辑您的Claude Desktop配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "codex": {
      "command": "ruby",
      "args": [
        "/ABSOLUTE/PATH/TO/codex-mcp/mcp-proxy.rb"
      ],
      "env": {
        "CODEX_URL": "http://localhost:3001/rpc"
      }
    }
  }
}

重要提示： 使用绝对路径。用以下方式获得你的：

cd codex-mcp && pwd
# Copy the output and append /mcp-proxy.rb

配置后： 退出并完全重新启动Claude Desktop。

克劳德代码

创建或编辑： ~/.config/claude.json

{
  "mcpServers": {
    "codex": {
      "command": "ruby",
      "args": [
        "/ABSOLUTE/PATH/TO/codex-mcp/mcp-proxy.rb"
      ],
      "env": {
        "CODEX_URL": "http://localhost:3001/rpc"
      }
    }
  }
}

替换 /ABSOLUTE/PATH/TO/ 与您的实际路径（使用 pwd 在codex mcp目录中）。

对于其他MCP客户端

Codex在以下位置公开了JSON-RPC 2.0端点 http://localhost:3001/rpc 使用模型上下文协议规范。配置您的MCP客户端以使用 mcp-proxy.rb 桥接或直接通过HTTP连接。

验证

打开AI Agent并说：

“开始修复身份验证错误的新任务”

如果AI Agent开始提出澄清问题，那么一切就都准备好了！ 🎉

故障排除

容器无法启动

# Check logs
docker-compose logs

# Common fixes:
# - Port 3001 in use: Change port in docker-compose.yml
# - Docker not running: Start Docker Desktop

克劳德无法连接到Codex

# 1. Check container is running
docker-compose ps

# 2. Test health endpoint
curl http://localhost:3001/health

# 3. Verify absolute path in config (not ~ or relative)

# 4. Restart Claude Desktop completely (Quit, then reopen)

MCP代理错误

# Test proxy manually
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | ruby mcp-proxy.rb

# Check Claude logs (macOS)
tail -f ~/Library/Logs/Claude/*.log

数据库问题

# Reset database (WARNING: deletes all data)
docker-compose down -v
docker-compose up -d

有用的命令

# View logs
docker-compose logs -f

# Restart server
docker-compose restart

# Stop server
docker-compose down

# Rebuild after code changes
docker-compose down && docker-compose build && docker-compose up -d

贡献

欢迎投稿！请打开问题或拉取请求。

由以下材料制成❤️ 和☕

“把你的待办事项变成任务。把你的工作变成冒险。你的咖啡休息时间变成当之无愧的XP奖金。”

相关 MCP