{"id":"934686d2-ea49-4be8-8e24-216165e427b5","slug":"wssjh822-coder","kind":"mcp","name":"coder","summary":"","owner":"wssjh822","repoUrl":"https://github.com/wssjh822/coder","license":"MIT","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-07-04T15:42:19.000Z","addedAt":"2026-10-21T21:29:57.847Z","logoUrl":"https://avatars.githubusercontent.com/u/254198239?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["utilities"],"tags":[],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-23T08:23:03.396Z","sample":false,"url":"https://conduits.dev/tools/wssjh822-coder","language":"Python","transports":["stdio"],"install":{"pypi":"ai-agent-coder"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# 🧠 AI Agent Coder\n\n> 终端 AI 编程助手 —— 真正的代码执行 + MCP 工具集成\n\n[![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n## ✨ 特性\n\n- 🤖 **流式对话** - 支持思考过程 (reasoning) 分离显示\n- 🔧 **MCP 协议支持** - 连接任意 MCP 服务器，调用外部工具\n- 💻 **真实代码执行** - Python 和 Shell 命令在真实终端运行\n- 🔄 **Agent 循环** - 自动执行 AI 回复中的代码块并反馈结果\n- 💾 **会话完整恢复** - 保存并恢复对话、工作目录、角色等完整状态\n- 🎯 **Tab 补全** - 命令、模型别名 (@)、对话标题 (#) 智能补全\n- 📦 **技能管理** - 保存和复用预设提示词\n- 🔍 **网络搜索** - 集成 Tavily API\n- 🧠 **ReAct 推理** - Thought → Action → Observation 显式推理链\n- 📋 **后台执行** - 不阻塞主流程的后台任务\n- 🤝 **多模型协作** - 委托其他模型处理特定问题\n\n## 🚀 快速开始\n\n### 安装\n\n```bash\n# 克隆项目\ngit clone https://github.com/wssjh822/coder.git\ncd coder\n\n# 安装依赖\npip install -r requirements.txt\n```\n\n启动\n\n```bash\npython main.py\n```\n\n首次配置\n\n1. 输入 /model add 启动交互式配置向导\n2. 配置 OpenAI 兼容的 API（支持 GPT、DeepSeek、Claude 等）\n3. 开始对话！\n\n📸 截图\n\nscreenshot.png\n\n📝 命令速查\n\n命令 说明\n/help 显示帮助\n/model add 交互式配置模型\n/model list 列出所有模型\n/conversation new 开始新对话\n/conversation list 列出对话\n/conversation load <名称> 加载对话\n/session restore 恢复上次会话\n/mcp add <名称> <命令> 添加 MCP 服务器\n/mcp tools 查看可用工具\n/skill create <名称> <内容> 创建技能\n/config set timeout 0 无超时模式\n/exit 退出（自动保存）\n\n🔌 MCP 支持\n\nAI Agent Coder 支持 MCP (Model Context Protocol)，可以连接各种 MCP 服务器：\n\n```bash\n# 添加文件系统服务器\n/mcp add filesystem npx -y @anthropic/mcp-filesystem /tmp\n\n# 添加 SQLite 服务器\n/mcp add sqlite npx -y @anthropic/mcp-sqlite --db /tmp/test.db\n\n# 查看可用工具\n/mcp tools\n```\n\nAI 会自动识别并调用 MCP 工具，无需手动干预。\n\n💻 代码执行\n\n在回复中输出代码块，系统会自动执行：\n\n```markdown\n```run_python\nprint(\"Hello World!\")\n```\n\n```run_shell\nls -la\npwd\n```\n\n```search\nPython asyncio 教程\n```\n```\n\n支持 cd 命令持久化：\n\n```markdown\n```run_shell\ncd /tmp && mkdir test && ls\n```\n```\n\n后台执行（不阻塞）\n\n```markdown\n```run_python_bg\nimport time\ntime.sleep(10)\nprint(\"后台任务完成\")\n```\n\n```sleep\n12\n```\n```\n\n🎯 使用场景\n\n· 📝 代码生成和调试 - 让 AI 写代码并自动运行验证\n· 📁 文件操作 - 结合 MCP 文件系统工具管理文件\n· 🔍 技术研究 - 搜索网络 + 运行代码示例\n· 📊 数据分析 - 处理 CSV、JSON 等数据\n· 🐛 Bug 排查 - 分析错误输出并自动修复\n\n🗂️ 项目结构\n\n```\ncoder/\n├── app.py            # Textual 主界面 (~3000行)\n├── ai_client.py      # OpenAI 兼容流式客户端\n├── code_runner.py    # Python/Shell 代码执行 (流式+后台)\n├── commands.py       # 命令解析和 Tab 补全 (含 ReAct)\n├── config.py         # 配置管理\n├── conversations.py  # 对话存储和管理\n├── mcp_client.py     # MCP 协议客户端\n├── search.py         # Tavily 搜索\n├── skills.py         # 技能管理\n├── main.py           # 入口\n├── requirements.txt  # 依赖\n├── setup.py          # 安装脚本\n├── pyproject.toml    # 项目配置\n├── LICENSE           # MIT 许可证\n└── .gitignore        # Git 忽略文件\n```\n\n⚙️ 配置\n\n配置文件位置: ~/.ai_agent_coder/config.json\n\n```json\n{\n  \"models\": [],\n  \"current_model\": \"\",\n  \"settings\": {\n    \"max_iterations\": 5,\n    \"timeout\": 120,\n    \"max_tokens\": 4096,\n    \"temperature\": 0.7,\n    \"context_length\": 8000,\n    \"compress_model\": \"\",\n    \"tool_retries\": 2\n  },\n  \"tavily_api_key\": \"\",\n  \"mcp_servers\": [],\n  \"last_session\": \"\"\n}\n```\n\n🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n1. Fork 项目\n2. 创建特性分支 (git checkout -b feature/amazing-feature)\n3. 提交更改 (git commit -m 'Add amazing feature')\n4. 推送到分支 (git push origin feature/amazing-feature)\n5. 创建 Pull Request\n\n详见 CONTRIBUTING.md\n\n📄 许可证\n\nMIT License - 详见 LICENSE\n\n🙏 致谢\n\n· Textual - 终端 UI 框架\n· MCP - 模型上下文协议\n· Tavily - 搜索 API"}