← 返回目录

Honcho

官方

为有状态智能体提供会推理的长期记忆。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 106 / 230
Stars: ★ 7.6k 非常热门
传输方式: Streamable HTTP
运行环境: 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: AGPL-3.0
最近提交: 2 天前

55FMRS · C

官方 Honcho MCP 服务器通过 streamable HTTP 提供有状态智能体记忆能力。资料明确说明了远程地址和认证方式，但未列出 MCP 工具标识符，因此工具清单留空。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

9/20

维护活跃度

11/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 清单声明了可用的 Streamable HTTP 端点和必需 Authorization，但未提供工具列表、参数定义、错误语义或真实 CI/测试证据，无法静态验证 MCP 初始化、工具握手及声明与实现的一致性。README 还同时出现 3.0.0 和 3.0.9 版本信息，因此仅给出保守分数。
安全与权限 9/20: Authorization 被标记为必需且保密，支持 OAuth 令牌或 Honcho API key，并提供可选工作区边界，这是基本的凭证和数据隔离措施。扣分原因是托管端点会接收并处理记忆、消息、嵌入和 LLM 相关数据，未见工具级最小权限、保留策略、数据流披露、危险操作确认或 MCP 级访问控制证据；自托管示例还显示认证默认关闭。未发现提示中的安全红线证据。
维护活跃度 11/20: 项目声明未归档，README 展示服务器和 SDK 的版本信息，且明确使用 AGPL-3.0；这些支持仍在维护和授权清晰的判断。扣分原因是源材料没有提交历史、CI 状态、依赖更新策略、漏洞响应渠道或明确的维护承诺；开放 issue 数量本身不增加分数。
文档质量 14/20: README 覆盖了托管与自托管安装、Python/TypeScript 示例、认证、架构、异步处理、配置、集成和常见运行组件，信息层次较完整。扣分原因是 MCP 工具名称、参数、返回值、错误处理、限制、成本、隐私/保留和故障排查证据不足，并存在 manifest 3.0.0 与 README 3.0.9 的版本不一致。
安装易用性 13/20: 提供了托管 MCP URL、Authorization 格式、可选工作区头，以及 Claude Code 和其他 MCP 客户端的配置示例；也提供 Docker 和本地 FastAPI/worker 路径。扣分原因是仍需手动获取并配置密钥，客户端覆盖有限，且自托管需要数据库、环境变量、迁移、API 服务和后台 worker，多步骤且未有可验证执行证据。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要跨会话记忆的有状态智能体
需要用户个性化和长期上下文的应用
使用 MCP 兼容客户端的开发者
希望托管或自行部署记忆服务的团队

不适合谁

只需要一次性对话且不保存历史的应用
需要已明确列出 MCP 工具名称和参数的集成评估
不希望向外部记忆服务发送消息或文档的场景

所需权限

需要向 mcp.honcho.dev 发送 Authorization 请求头
需要有效的 OAuth 访问令牌或 Honcho API 密钥
可选需要指定默认工作区 ID
服务可能接收并处理会话消息、事件、文档或工具轨迹

风险与副作用

发送到 Honcho 的内容可能包含敏感个人信息或应用数据
后台推理是异步的，新消息不会立即反映在聊天或表示结果中
使用托管服务需要依赖网络、凭据和 Honcho 服务可用性
AGPL-3.0 许可可能影响自行部署和再分发方案

安装接入

准备工作

运行环境：远程托管（无需本地环境）

使用支持 MCP 的客户端连接 https://mcp.honcho.dev。Authorization 为必填请求头，格式为 Bearer <token>；令牌可以是 OAuth 访问令牌或来自 app.honcho.dev、以 hch- 开头的 Honcho API 密钥。可选设置 X-Honcho-Workspace-ID 指定默认工作区。

.mcp.json

{"mcpServers":{"honcho":{"url":"https://mcp.honcho.dev","headers":{"Authorization":"Bearer <token>"}}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "honcho": {
      "url": "https://mcp.honcho.dev",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http honcho https://mcp.honcho.dev --header 'Authorization: Bearer <token>'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中连接 https://mcp.honcho.dev 并带上 Authorization: Bearer <token> 头，连接成功后客户端应列出 Honcho 的工具；未提供有效 token 则连接失败。

常见排障

确认 Authorization 请求头使用 Bearer <token> 格式
确认令牌有效，并检查 Honcho API 密钥是否以 hch- 开头
确认 MCP 客户端支持 streamable HTTP
检查 X-Honcho-Workspace-ID 是否指向正确工作区
新消息刚写入时，等待后台推理队列处理完成
自行托管时检查数据库、所需 LLM API 密钥、迁移、API 服务和后台 deriver 是否运行

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查询 Honcho 中我的 peer 的表示
把这段对话存到 Honcho 的 session 里
搜索 workspace 中关于该用户偏好的消息
给这个 session 生成上下文摘要

使用场景

为编码智能体提供持久化记忆

保存对话、事件、文档和工具轨迹

查询用户或智能体的长期表示与洞察

生成适合注入大语言模型的会话上下文

对消息执行混合搜索

支持客户端

Claude Code

Cursor部分支持

Cline部分支持

Windsurf部分支持

OpenCode部分支持

OpenClaw部分支持

Hermes部分支持

依据项目文档列出，未经本站实测。

详细介绍

Honcho 是用于构建有状态智能体的记忆基础设施。它存储消息、事件、文档或工具轨迹，并在后台推理，形成关于用户、智能体、群组、项目和想法的持续表示；随后可查询上下文、搜索结果、表示或自然语言洞察。服务支持托管使用，也可自行托管 FastAPI 服务器。