项目简介

'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回退服务。

安装步骤

  1. 安装系统: 在终端中运行提供的安装脚本来设置 'Coding' 工具包:
    ./install.sh
  2. (可选)启动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

信息

分类

开发者工具