Aiana Claude Code MCP 服务器

关键词

内存管理语义检索会话工具上下文注入

使用说明

  • 项目简介

    • Aiana 的 MCP 服务器实现提供一组工具，允许 Claude Code 调用本地内存管理、会话检索、偏好设置等功能，从而在本地环境中为大语言模型提供结构化的上下文和能力。

  • 主要功能点

    • 实现 MCP 服务器核心：通过 MCP SDK 暴露 list_tools 与 call_tool 等接口，支持 Claude Code 调用工具、查询状态、获取会话等。
    • 工具集成：memory_search、memory_add、memory_recall、memory_feedback、session_list、session_show、preference_add、aiana_status 等工具。
    • 存储与向量后端灵活切换：内置对 SQLite、Mem0、Qdrant、Redis 等后端的集成，默认 SQLite，Mem0 为主、Qdrant 作为回退；Embeddings 通过嵌入模型实现向量搜索。
    • 上下文注入支持：ContextInjector 根据存储层提供用户偏好、项目信息、最近记忆等，注入到 Claude 的会话上下文中。
    • 模块化设计：提供清晰的后端初始化、工具注册、上下文生成等分层实现，便于扩展与测试。
    • 本地化部署优先：强调本地数据存储与处理，便于离线工作与隐私保护。

  • 安装步骤

    1. 准备环境
      • 安装 Python 以及必要依赖（建议使用虚拟环境）。
    2. 安装与部署
      • 安装本仓库的 Python 包（包括 MCP 功能的依赖）。
      • 安装示例命令（在命令行执行）：pip install -e ".[all]"（如需要完整功能集；也可仅安装基础包）。
    3. 启动 MCP 服务器
      • 使用 CLI 启动：aiana mcp
      • 服务器默认监听端口为 8765，可在配置中修改，具体端口在运行时通过参数指定或配置文件控制（参考 README 的 Docker 配置示例）。
    4. 依赖说明
      • 如未安装 MCP 相关依赖，启动时会给出安装提示，请按提示安装：pip install mcp

  • 服务器配置（MCP 客户端需要的配置信息，JSON 格式） { "server_name": "aiana", "command": "aiana", "args": ["mcp"] } 说明：

    • server_name：在 Claude Code 客户端中用于标识该 MCP 服务器的名称，应与服务器实际名称保持一致（此处为 aiana）。
    • command：启动 MCP 服务器的命令，客户端通过该命令来启动与连接服务器。
    • args：启动命令的参数，示例为 ["mcp"]，表示以 MCP 模式启动服务器。

  • 基本使用方法

    • 在 Claude Code 中配置客户端连接，指向上面的服务器信息（名称、启动命令和参数）。
    • 启动后，通过 Claude Code 的 MCP 接口调用 memory_search、memory_recall、session_list 等工具，获取结构化输出并将结果用于上下文注入或直接应答。
    • 如需调试或查看服务器状态，可以在命令行执行 aiana status 获取当前系统状态信息；通过 aiana mcp 启动 MCP 服务时，系统会输出运行日志。
    • 参考仓库 README 的 MCP 服务工具清单，了解每个工具的输入字段与用途。

服务器信息

访问项目