Tessera MCP 服务器

Markdown 使用说明：

• 项目简介 Tessera MCP 服务器是一个基于 MCP 协议的后端实现，提供资源、工具和提示等能力，供 MCP 客户端（如 Claude Desktop）通过 JSON-RPC 调用来读取资源、执行工具、以及获取和渲染 Prompt 模板等上下文信息。该服务器在启动时可自动进行数据同步、并通过文件监听持续保持索引与向量数据库的一致性。

• 主要功能点

  • 资源与工具暴露：通过 MCP 的资源与工具装饰器，将文档索引、工作区状态、搜索、记忆、知识图谱等能力暴露给客户端。
  • 工具集合（Tools）：包括文档搜索、内存管理、文件读取、源文件列举、工作区与项目状态、知识图谱、统一搜索、索引/同步、 memories 的导出/导入、以及服务器健康等多种操作。
  • 数据与索引管理：内置增量同步、向 LanceDB/向量存储的索引、以及自动同步逻辑，确保本地数据与向量索引的一致性。
  • 会话与追踪：提供会话层面的状态信息、分析数据、以及对查询的分析记录（Analytics）。
  • 支持多种传输与 JSON-RPC：通过 FastMCP 实现 MCP 接口，客户端可通过 JSON-RPC 与之通信。

• 安装步骤

  • 准备环境
    1. 从仓库获取代码并进入项目目录。
    2. 创建并激活虚拟环境（推荐）。
  • 安装与配置 3) 安装开发模式包：执行安装命令（如 pip install -e .），确保依赖就绪。 4) 按需要通过 tessera init 进行工作区配置的引导，生成 workspace.yaml。
  • 启动服务器 5) 通过 Python 运行 mcp_server.py（在已配置好虚拟环境的前提下）。服务器启动后会监听并通过 MCP 与 Claude Desktop 等客户端对接。
  • Claude Desktop 集成 6) 在 Claude Desktop 的配置中添加 Tessera 服务器，使用命令指向本服务器的 Python 解释器和 mcp_server.py 脚本，确保客户端能通过 JSON-RPC 与服务器通信。 7) 重启 Claude Desktop，使 Tessera 出现在 MCP 集成选项中。
  • 使用前置注意
    • 服务器会在启动后尝试进行自动同步（如 workspace.sync_auto 为 true），必要时会建立本地数据库和向量索引。
    • 客户端交互时，请按需调用搜索、记忆、导出/导入等工具来实现知识检索与记忆管理。

• 服务器配置（MCP 客户端所需信息） 说明：MCP 客户端需要知道如何启动并连接到 Tessera MCP 服务器。以下为配置要点（以描述性信息呈现，非代码块）：

  • server name（服务器名称）: tessera
  • command（启动命令）: 指向你所在环境中用于运行 Tessera 的 Python 解释器路径，例如 /path/to/venv/bin/python
  • args（命令参数）: 指向 Tessera 的 MCP 服务入口脚本，例如 /path/to/project-tessera/mcp_server.py 该配置确保客户端能够在需要时通过该服务器执行 MCP 调用，获得资源、工具和提示等能力。 注释：MCP 客户端本身不需要实现具体逻辑，只需要知道服务器的启动命令与参数即可建立连接并通过 JSON-RPC 传输请求/响应。

• 基本使用方法

  • 启动后，在 Claude Desktop 中选择 Tessera 服务器进行查询、记忆、以及工作区相关操作。
  • 常见操作场景包括：
    • 使用 search_documents、unified_search、read_file、list_sources 等工具在本地工作区中检索信息。
    • 使用 remember、recall、learn、list_memories、export_memories、import_memories 管理跨会话记忆。
    • 使用 ingest_documents、sync_documents、tessera_status、health_check 等工具进行数据的导入、同步与健康检查。
  • 服务器的自动同步与文件监控可在后台保持索引与向量库的更新，提升响应时效性。

• 额外信息

  • 该实现包含大量工具、资源与知识图谱相关能力，适用于本地、离线的企业或个人知识管理场景。
  • 代码还提供了测试用例与模拟环境，便于在开发阶段进行本地验证与扩展。