项目简介

LUCA Dev Assistant 是一个功能强大的通用开发助手，利用智能体编排技术，旨在通过一个对话式AI助手，帮助开发者完成整个软件开发生命周期中的任务，从项目搭建到代码编写、测试和文档创建。LUCA 采用模块化的 Model Context Protocol (MCP) 服务器设计，能够灵活地集成各种能力，例如文件系统访问、数据库交互等。

主要功能点

智能体编排: LUCA 根据对话上下文和项目需求，动态调整并协调专业的智能体团队（如代码编写、测试、文档生成智能体）。
模块化MCP服务器: 通过即插即用的MCP服务器实现不同的功能模块，例如文件读写、知识检索等。
领域预设: 快速切换通用开发、Web开发、数据科学或量化金融等开发领域。
安全本地执行: 在隔离环境中（如Docker）运行单元测试和代码检查，确保代码质量。
知识检索: 集成知识库（如Chroma DB, LightRAG）为智能体提供上下文信息。
可定制的学习模式: 提供新手模式、专家模式、大师模式，调整助手的沟通风格和详细程度。

安装步骤

确保您的系统中已安装 Python 3.8 或更高版本。
打开终端。
使用 pip 安装 lucalab 包：
```
pip install lucalab
```
设置您的LLM API密钥。LUCA 支持 OpenAI 兼容的端点、Claude 或通过 MCP 连接的本地模型。例如，设置 OpenAI 密钥：
```
export OPENAI_API_KEY="sk-YOUR_API_KEY"
```

服务器配置 (供MCP客户端参考)

LUCA Repository 包含一个基于 StdIo 协议的简单文件系统 MCP 服务器实现 ('mcp_servers/filesystem_server.py')。如果您想通过 另一个 MCP 客户端连接到 此服务器实现，您需要知道如何启动它。

该文件系统服务器是一个独立的 Python 脚本，可以通过标准输入输出与 MCP 客户端通信。一个典型的 MCP 客户端（如 LUCA 内部的 'MCPClientManager' 或其他遵守 MCP StdIo 传输协议的客户端）需要配置启动这个服务器脚本的命令及其参数。

例如，一个 MCP 客户端用于连接到 此存储库中包含的 文件系统服务器的配置可能类似于以下 JSON 结构中的一项：

[
  {
    "name": "luca_filesystem_server_in_repo",
    "command": ["python3", "path/to/your/cloned/repository/mcp_servers/filesystem_server.py"],
    "description": "此配置用于连接到Luca Dev Assistant仓库中包含的文件系统MCP服务器示例。",
    "workingDirectory": "path/to/your/cloned/repository" // 确保服务器脚本在其正确的上下文目录运行
  }
  // 客户端可以配置连接到 LUCA repository 内置的其他 MCP 服务器
  // 或外部独立的 MCP 服务器
]

'name': 给服务器连接起一个名称 (例如, 'luca_filesystem_server_in_repo').
'command': 启动服务器的可执行文件 (例如, 'python3').
'args': 传递给 command 的参数，这里是服务器脚本的路径 (例如, '["path/to/your/cloned/repository/mcp_servers/filesystem_server.py"]'). 请将 'path/to/your/cloned/repository' 替换为 Luca Dev Assistant 仓库在您本地文件系统中的实际路径。
'description': 服务器的描述。
'workingDirectory': 服务器进程的当前工作目录，通常应设置为仓库根目录以便服务器正确找到文件。

请注意： 上述 JSON 只是 MCP 客户端如何配置连接到这个特定服务器实现 的一个示例。LUCA Dev Assistant 应用程序本身通过其内置的 'MCPClientManager' 组件管理与 MCP 服务器的连接，其配置可能通过 Streamlit UI 或其他方式进行。用户直接使用 LUCA 时通常不需要手动创建上述 JSON 配置。

基本使用方法

安装并配置好API密钥后，您可以通过以下两种主要方式使用 LUCA：

命令行模式 (用于单次交互或测试):

luca "构建一个简单的Python FastAPI服务"

LUCA 将处理您的请求并在终端输出结果。

Streamlit UI 模式 (推荐用于持续对话和项目开发): 只需运行 'luca' 命令，它将自动启动 Streamlit 用户界面：
```
luca
```
LUCA 会检测缺失的配置，搭建项目骨架，并在默认浏览器中打开 UI 界面（通常在 'http://localhost:8501'）。在 UI 中，您可以进行对话、管理智能体和MCP服务器连接。

关键词

信息