mcpField
O
openharness

openharness

本地服务
github.com/philo-kimAI 与智能体032 周前更新
代码仓库

关于 openharness

openharness 是本地 MCP 服务，为使用多种编码 Agent 的开发者提供会话发现能力。它返回 Claude Code、Codex CLI 和 Gemini CLI 的近期会话路径及元数据，让 Agent 可直接读取并参照彼此的工作。

主要功能

  1. 01按项目查找近期会话
  2. 02查询指定 Agent 的会话
  3. 03返回会话路径与元数据
  4. 04支持 Claude Code、Codex CLI 和 Gemini CLI

适用场景

  1. 01让 Codex CLI 参考 Claude Code 的近期工作
  2. 02按项目查找其他 Agent 的会话
  3. 03为 Agent 提供会话文件位置

MCP 相关

作为 MCP 服务，提供 get_agent_sessions 和 get_agent_session 工具，返回会话路径及元数据。它不读取、转发或存储会话内容；Agent 需自行读取本地文件。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "philo-kim-openharness": {
      "command": "npx",
      "args": [
        "-y",
        "@freebird-ai/openharness"
      ]
    }
  }
}
启动命令npx -y @freebird-ai/openharness

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@freebird-ai/openharness0.1.1

工具

2

收录的工具列表 · 更新于 3 周前

参数类型必填说明
projectstring是项目目录的绝对路径。必填。仅返回与此项目匹配的会话。

详细介绍

OpenHarness

一个本地 MCP 服务，可查找 AI 编码 Agent 的近期会话文件，并让它们相互引用。

无需专用的 harness，也能像 harness 一样运行。在保留现有工具环境的同时，提供连接各 Agent 会话的发现层。

支持的 Agent（MVP）

Agent会话路径格式
Claude Code~/.claude/projects/JSONL
Codex CLI~/.codex/sessions/JSONL
Gemini CLI~/.gemini/tmp/<hash>/chats/JSON

前提条件

  • 每个 Agent 都必须能够直接读取本地文件。
  • OpenHarness 仅提供路径和元数据，不会转换、转发或存储会话内容。

安装

npm install -g @freebird-ai/openharness
openharness init

这会在每个 Agent 的配置中将 OpenHarness 注册为 MCP 服务。

MCP 工具

get_agent_sessions

返回所有 Agent 的近期会话路径，并按项目筛选。

输入：

{ "project": "/Users/me/my-app" }

输出：

[
  {
    "agent": "claude-code",
    "path": "/Users/me/.claude/projects/-Users-me-my-app/session.jsonl",
    "format": "jsonl",
    "updatedAt": "2026-03-17T14:32:00Z",
    "matchedProject": "/Users/me/my-app",
    "matchedBy": "directory-name"
  }
]

如果未找到会话，则返回 null。

get_agent_session

返回指定 Agent 的近期会话路径。

输入：

{ "agent": "claude-code", "project": "/Users/me/my-app" }

输出：

{
  "agent": "claude-code",
  "path": "/Users/me/.claude/projects/-Users-me-my-app/session.jsonl",
  "format": "jsonl",
  "updatedAt": "2026-03-17T14:32:00Z",
  "matchedProject": "/Users/me/my-app",
  "matchedBy": "directory-name"
}

如果未找到会话，则返回 null。

项目匹配

Agent策略
Claude Code将项目路径中的 - 转义为目录名
Codex CLI使用会话 JSONL 中的 Workspace 字段
Gemini CLI根据项目路径哈希匹配 tmp/<hash>/

工作原理

User → Codex: "Review what Claude Code worked on recently"

Codex → OpenHarness MCP: get_agent_session({ agent: "claude-code", project: "..." })
Codex ← receives session path + metadata
Codex → reads the JSONL file directly and performs review

无需在 Agent 指令文件中添加规则。MCP 工具描述足以让 Agent 自然地使用这些工具。

手动配置 MCP

如果你更愿意手动配置，而不是使用 init：

{
  "mcpServers": {
    "openharness": {
      "command": "openharness",
      "args": []
    }
  }
}

将其添加到 Agent 的 MCP 配置文件中：

Agent配置文件
Claude Code~/.claude/mcp.json 或项目 .mcp.json
Codex CLI项目 .codex/
Gemini CLI~/.gemini/settings.json

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。