Tessera MCP Server
使用说明(Markdown 格式)
- 项目简介
- Tessera 是一个面向“模型上下文服务”的后端,核心职责是以标准化方式向 LLM 客户端提供可访问的 Resources、Tools 与 Prompts,并通过 MCP 协议进行 JSON-RPC 风格的请求/响应交互。实现目标包括会话管理、能力声明以及对多种传输协议的支持,作为 LLM 应用的上下文服务平台。
- 主要功能点
- 资源管理(Resources):托管并管理数据资源,提供数据访问能力与结构化检索能力。
- 工具注册与执行(Tools):注册可调用的外部功能,LLM 客户端可通过工具调用外部能力。
- 提示模板(Prompts):定义和渲染可定制的 Prompt 模板,支持多场景的 LLM 交互。
- JSON-RPC 通信:服务器端接收 JSON-RPC 请求,返回统一的 JSON-RPC 响应或通知。
- 会话与授权:基于会话的令牌与作用域模型实现 deny-by-default 的访问控制。
- 多传输协议:支持 stdio(标准输入输出)、SSE、WebSocket 等传输通道以适配不同客户端。
- 本地嵌入式存储:内置 SQLite/FAISS 等组件,避免对外部依赖的运行时需求。
- 安全与可扩展性:严格的权限控制、集合/项目的域划分,以及对模型版本变更的向后兼容支持。
- 安装步骤
- 依赖环境准备
- Python 3.11 及以上
- 本地 Python 依赖可通过标准的 Python 包管理工具安装(例如 pip/poetry),若仓库提供的依赖文件,请按项目要求安装。
- 项目获取与安装
- 将仓库克隆到本地:git clone https://github.com/danieliser/tessera.git
- 进入目录:cd tessera
- 安装依赖并准备环境(参考项目 README 中的快速启动与依赖说明,确保本地有 Python 环境和所需的依赖库)
- 运行 MCP 服务器(服务器端)
- 使用 MCP 标准的启动方式,参照仓库 README 的 Quick Start 部分:
- 在 .mcp.json 中为 tessera 配置一个服务器,其启动命令与参数示例如下:
- command: uv
- args: ["--directory", "/path/to/tessera", "run", "python", "-m", "tessera", "serve"]
- 在 .mcp.json 中为 tessera 配置一个服务器,其启动命令与参数示例如下:
- 也可直接按照本地开发环境的运行方式启动 Tessera 的 MCP 服务(具体命令请结合实际本地路径与环境变量配置)。
- 使用 MCP 标准的启动方式,参照仓库 README 的 Quick Start 部分:
- 客户端配置(请仅参考,MCP 客户端需求)
- MCP 客户端需要知道服务器启动命令与连接信息(server name、command、args 等)。以下仅作说明,实际客户端配置由 MCP 客户端负责,不需要在此处编写代码:
- server name:tessera
- command 与 args:如上启动 Tessera 服务时使用的 uv 启动参数(请按实际部署路径配置)
- MCP 客户端需要知道服务器启动命令与连接信息(server name、command、args 等)。以下仅作说明,实际客户端配置由 MCP 客户端负责,不需要在此处编写代码:
- 测试与验证
- 运行单元测试或集成测试,确保 MCP 服务器按预期实现 JSON-RPC 通信、资源/工具/提示的注册与调用能力。
-
关键词 资源管理, 工具执行, 向量检索, JSON-RPC, 本地嵌入式存储
-
分类ID 6