项目简介

Winx Agent 是一个用 Rust 编写的高性能代码智能体，它旨在作为大型语言模型（LLM）的后端，通过 Model Context Protocol (MCP) 提供强大的代码理解和操作能力。Winx Agent 汲取了 WCGW 项目的精华，并以 Rust 进行了高性能的重新实现，为 Claude 等 MCP 客户端提供高效、语义化的代码服务。

主要功能点

高性能: 使用 Rust 编写，保证速度和效率。
语义代码分析: 集成 Language Server Protocol (LSP) 以理解代码符号。
优化的文件编辑: 提供高效的文件差异、编辑和插入算法。
项目记忆: 受到 Serena 启发的记忆系统，用于维护会话间的上下文。
高级顺序思考: 支持任务遵循和完成的推理工具。
语法验证: 在应用修改前进行代码语法验证。
SQL 支持: 集成 SQL 查询执行接口。
MCP 集成: 作为 MCP 服务器，为 Claude 和其他 LLM 提供服务。
交互式终端: 支持交互式命令，提供实时反馈。
多种操作模式: 支持 'wcgw', 'architect' 和 'code_writer' 模式。
大型文件处理: 支持增量编辑大型文件，避免 token 限制问题。

安装步骤

克隆仓库:

git clone https://github.com/gabrielmaialva33/winx-code-agent.git
cd winx-code-agent

编译项目:

cargo build --release

基本使用:

./target/release/winx [workspace_path]

如果未提供路径，则当前目录将用作工作区。

服务器配置

要将 Winx Agent 集成到 Claude Desktop，您需要配置 'claude_desktop_config.json' 文件。此文件通常位于 macOS 的 '~/Library/Application Support/Claude/' 目录下。

在 'mcpServers' 部分添加以下配置：

{
  "mcpServers": {
    "winx": {
      "command": "/path/to/winx",  // 替换为 winx 可执行文件的实际路径
      "args": [],                 // 启动参数，此处为空
      "env": {
        "NO_COLOR": "1",          // 禁用颜色输出，避免 JSON 解析问题
        "RUST_LOG": "error"      // 设置 Rust 日志级别为 error
      }
    }
  }
}

配置说明:

'server name': 'winx' - 服务器名称，在 Claude Desktop 配置中引用。
'command': '/path/to/winx' - 请替换为实际的 Winx Agent 可执行文件路径，通常是 './target/release/winx'。
'args': '[]' - 启动参数，此处为空，您可以根据需要添加工作区路径等参数。
'env': 环境变量配置。
- 'NO_COLOR: "1"': 务必添加此项，禁用 Winx Agent 的彩色输出，避免 MCP 客户端解析 JSON-RPC 消息时出现 ANSI 颜色代码干扰。
- 'RUST_LOG: "error"': 可选，设置 Rust 日志级别为 error，减少日志输出。

配置完成后，重启 Claude Desktop 应用，您应该能看到 MCP 服务器图标，表示 Winx Agent 已成功集成。

基本使用方法

启动 Winx Agent 服务器: 按照安装步骤编译后，运行 './target/release/winx [workspace_path]' 启动服务器。
配置 Claude Desktop: 根据上述 "服务器配置" 步骤，配置 'claude_desktop_config.json' 文件，并重启 Claude Desktop。
在 Claude 中与 Winx Agent 交互: 您可以通过 Claude 客户端向 Winx Agent 发送请求，例如：
- 让 Claude 探索和理解您的代码库
- 请求代码分析和语义理解
- 让 Claude 编辑文件
- 执行 SQL 查询并分析结果
- 运行 shell 命令并获取实时反馈
- 实现复杂的顺序思考流程

具体的使用示例和工具列表请参考仓库 README.md 文件。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息