项目简介

ExoMind是一个先进的AI驱动认知架构开发环境,它将SPARC开发方法论、多智能体协同、个人知识管理以及外部服务(如Google Workspace)深度融合。它通过集成和配置一系列遵循Model Context Protocol (MCP) 的服务器,为大型语言模型(LLM)客户端(如Claude Code)提供丰富的上下文信息、可调用的工具和可定制的交互模式,从而提升LLM在软件工程、研究和日常管理中的效率和决策能力。

主要功能点

  • 智能体协作与任务编排: 拥有54+专业AI智能体,支持并行执行和跨会话记忆,实现复杂任务的分解、执行与协调。
  • 外部服务集成: 通过MCP服务器无缝集成Google Workspace(Gmail和日历),实现邮件发送、日程管理等功能。
  • 上下文获取与管理: 提供网页内容抓取、文档解析和多源信息聚合能力,为LLM提供全面准确的上下文。
  • 自动化技能生成: 能够自动将任何文档网站转化为LLM可用的技能,并生成详细的技能指南和代码示例。
  • 语音交互: 支持与LLM进行自然语音对话,提供本地语音转文本(STT)和文本转语音(TTS)服务。
  • GitHub自动化: 实现PR管理、代码审查、发布协调等GitHub工作流的自动化。
  • SPARC开发流程: 遵循SPARC方法论(Specification, Pseudocode, Architecture, Refinement, Completion),支持系统性软件开发。

安装步骤

  1. 克隆仓库及子模块: 使用 'git clone --recurse-submodules https://github.com/natea/ExoMind.git' 命令克隆项目到您的本地机器。
  2. 安装Node.js及Git: 确保您的系统已安装Node.js (v18或更高版本) 和 Git。
  3. 安装Claude Code CLI: 安装用于与MCP服务器通信的Claude Code命令行工具或桌面应用。
  4. 初始化核心MCP服务: 运行项目中的配置脚本或手动添加 'claude-flow' 等核心MCP服务器,这些是实现智能体编排的基础。
  5. 配置可选MCP服务: 根据您的需求配置其他MCP服务,例如:
    • Google Workspace MCP: 用于Gmail和Google日历集成。
    • GetGather MCP: 用于智能网页内容抓取。
    • Skill Seekers MCP: 用于自动化技能生成。
    • VoiceMode MCP: 用于语音交互。
  6. 进行认证: 针对需要认证的服务(如Google Workspace),按照提示完成OAuth认证流程。

服务器配置

ExoMind集成了多个MCP服务器,这些服务器通过Claude Code客户端的MCP设置进行管理。您需要将以下MCP服务器配置添加到Claude Code的设置文件(通常是 '~/.config/claude/mcp_settings.json')中。这里提供的是MCP客户端所需的主要配置点,这些配置指示Claude Code如何启动和连接到相应的MCP服务器。

  • claude-flow (核心智能体编排):

    • 功能: 提供多智能体编排框架,是ExoMind大部分AI功能的基础。
    • 配置方式: 在Claude Code的MCP设置中,为 'claude-flow' 服务器指定 'command' 为 'npx','args' 为 'claude-flow@alpha', 'mcp', 'start'。
  • composio (Google Workspace等服务统一集成):

    • 功能: 通过统一认证层提供Google Workspace(Gmail, Calendar)等服务。
    • 配置方式: 为 'composio' 服务器指定 'command' 为 'npx','args' 为 'composio-core', 'mcp'。同时,需要在环境变量中设置 'COMPOSIO_API_KEY',该密钥需从Composio Dashboard获取。
  • google-workspace (直接Google Workspace集成):

    • 功能: 提供对Gmail和Google Calendar的直接访问和管理。
    • 配置方式: 为 'google-workspace' 服务器指定 'command' 为 'npx','args' 为 '@modelcontextprotocol/server-google-workspace'。在环境变量中设置 'GOOGLE_CREDENTIALS_PATH' 为您的Google Cloud凭据文件路径,'GOOGLE_TOKEN_PATH' 为OAuth认证后生成的token文件路径。
  • getgather (智能上下文获取):

    • 功能: 用于网页内容抓取、文档处理和研究自动化。
    • 配置方式: 为 'getgather' 服务器指定 'url' 为 'http://127.0.0.1:23456/mcp'。请注意,在Claude Code尝试连接前,您需要手动启动 'mcp-getgather' 服务器:进入项目的 'modules/mcp-getgather' 目录并运行 'python server.py'。
  • voicemode (语音交互):

    • 功能: 实现与LLM的语音对话,支持本地或OpenAI的语音转文本和文本转语音。
    • 配置方式: 为 'voicemode' 服务器指定 'command' 为 'uvx','args' 为 '--refresh', 'voice-mode'。可能需要预先运行 'uvx voice-mode-install' 进行安装。

基本使用方法

  1. 启动Claude Code: 确保您的Claude Code CLI或桌面应用已运行。
  2. 验证MCP服务器状态: 在终端运行 'claude mcp list' 命令,查看所有已配置MCP服务器的状态。
  3. 使用SPARC工作流: 运行 'npx claude-flow@alpha sparc tdd "创建一个用户认证REST API端点"' 来启动一个完整的测试驱动开发流程。
  4. 进行Google Workspace操作: 在Claude Code中直接使用自然语言指令,例如:"查阅我今天的Gmail收件箱" 或 "安排下周一的团队会议"。
  5. 进行上下文获取: 使用 'getgather' 技能从指定网址提取信息,例如:"使用getgather从https://docs.example.com提取所有API文档"。
  6. 进行语音对话: 运行 'claude converse' 命令启动语音对话模式,直接与Claude进行口语交流。
  7. 管理GitHub: 使用Claude Code中的GitHub相关命令,例如:"自动化PR审查 #42"。

信息

分类

AI与计算