项目简介
'Coding' 是一个功能全面的AI辅助开发工具包,旨在通过提供实时的会话日志、代码约束监控、语义化知识管理和多智能体代码分析等核心能力,赋能AI开发者。它特别支持与 Claude Code 进行完整的MCP服务器集成,并为 GitHub CoPilot 提供增强的VSCode集成与回退服务,确保在不同AI助手环境下功能一致。
主要功能点
- 健康系统: 实时监控、自动修复和状态指示,确保工具链服务稳定运行。
- 实时会话日志 (LSL): 对LLM与用户之间的对话进行实时分类和路由,支持多项目和安全脱敏,实现零数据丢失的会话记录。
- 约束监控: 通过预工具使用钩子(PreToolUse hooks)实时执行代码质量、安全、架构等18项约束,确保代码质量,并提供仪表盘监控和REST API访问。
- 知识管理 (UKB/VKB): 捕捉、组织和可视化开发洞察。它支持Git提交分析和实时会话学习,提供强大的语义搜索能力和知识图谱可视化界面。
- 轨迹生成: 自动进行项目分析和文档生成,全面追踪项目开发状态和演进过程。
- 多智能体分析: 内置10个专业AI智能体,负责综合代码分析任务,例如Git历史分析、语义分析、外部模式研究、洞察生成和输出质量保障。
- LLM集成: 为Claude Code提供完整的Model Context Protocol (MCP) 服务器集成,并为GitHub CoPilot提供增强的VSCode集成和HTTP回退服务。
安装步骤
- 安装系统: 在终端中运行提供的安装脚本来设置 'Coding' 工具包:
./install.sh - (可选)启动Qdrant服务: 如果您计划利用 'Coding' 的向量搜索和语义匹配功能(例如知识管理中的嵌入搜索),请确保您的系统上已安装Docker,并运行Qdrant向量数据库:
docker run -p 6333:6333 qdrant/qdrant
服务器配置
'Coding' 作为 Model Context Protocol (MCP) 服务器,能够接收来自兼容LLM客户端的JSON-RPC请求。对于 MCP 客户端,您需要配置其连接到 'Coding' 服务器,通常这涉及指定服务器的启动命令和参数。
以下是一个 MCP 客户端配置的JSON示例,其中包含连接 'Coding' 服务器所需的基本信息和参数注释:
{ "server_name": "Coding AI Toolkit Server", "command": "coding", "args": [], "description": "Coding AI 开发工具包提供知识管理、代码约束监控和多智能体分析等服务。默认启动所有功能。要与Claude Code等LLM客户端集成,请确保已设置ANTHROPIC_API_KEY等必要的API密钥环境变量。", "environment": { "ANTHROPIC_API_KEY": "您的Anthropic API密钥", "OPENAI_API_KEY": "您的OpenAI API密钥 (可选)" }, "transport": "stdio", "capabilities": ["resource_access", "tool_execution", "prompt_rendering", "session_management"] }
- server_name: MCP服务器在客户端显示的用户友好名称。
- command: 启动 'Coding' 服务器的主执行命令,这里是 'coding'。
- args: 传递给 'coding' 命令的参数列表。
- '[]': 启动 'Coding' 的所有功能。
- '["--claude"]': 专门为 Claude Code 代理启动 'Coding'。
- '["--copilot"]': 专门为 GitHub CoPilot 代理启动 'Coding'。
- description: 对此 MCP 服务器功能和用途的简要描述。
- environment: 运行 'Coding' 服务器所需的关键环境变量,例如 Anthropic 或 OpenAI 的 API 密钥,以便其可以调用外部LLM。
- transport: MCP 服务器与客户端通信所使用的传输协议,'stdio'(标准输入输出)是常见的默认选项。
- capabilities: 服务器声明其能够提供的 MCP 功能列表,包括资源访问、工具执行、提示渲染和会话管理等。
对于像 GitHub CoPilot 这样通过 HTTP API 集成的客户端,'Coding' 会启动一个 HTTP 服务器(默认端口 '8765')。客户端可以直接通过 HTTP POST 请求调用其功能,例如调用语义分析功能:
curl -X POST http://localhost:8765/api/semantic/analyze-repository \ -H "Content-Type: application/json" \ -d '{"repository": ".", "depth": 25}'
基本使用方法
- 启动所有功能:
coding - 启动特定AI代理(例如Claude Code):
coding --claude - 启动知识管理可视化服务器: 运行以下命令启动可视化界面,随后可在浏览器中访问 'http://localhost:8080' 查看知识图谱。
vkb - 手动捕捉Git提交洞察: 运行以下命令,您可以从最近的Git提交中捕捉有价值的开发洞察。
ukb - 查看系统健康状态: 运行测试脚本,快速检查 'Coding' 工具包所有组件的健康状况。
./scripts/test-coding.sh
信息
分类
开发者工具