officelens

officelens

officelens 是一个小型本地桥接程序，用于连接 Family Office Registry 托管的 MCP 服务。该注册库汇总了经过来源核实并标注日期的家族办公室及相关公司，以瑞士和列支敦士登为中心，覆盖范围还延伸至奥地利、德国、迪拜以及在美国注册的顾问。

该桥接程序不保存任何注册库数据，也不会自行执行查询。它会在本地提供上游服务的工具列表，该列表与从实时端点捕获的内容完全一致；并将每次工具调用转发至上游，原样返回结果。捕获的全部功能均为只读：本次重建没有添加任何写入能力。

工具

• search_registry — 搜索经过核实的家族办公室及相关公司。所有参数均为可选：q（对开放字段进行自由文本搜索，包括名称、城市、注册编号、法律形式和关注领域标签；提供密钥后还会搜索相关人员和宗旨条款）、country（CH、LI、AT、DE、AE 或 US）、canton（瑞士州代码，例如 ZH、ZG 或 GE）、type（SFO、MFO 或 intermediary）、alloc（公司的投资方式——仅订阅用户可用的筛选条件，无密钥时搜索会拒绝执行）、page（从 1 开始，默认值为 1）、size（每页 1-25 条结果，默认值为 10；没有订阅密钥时上限为 25）以及 purpose（用一行说明用户尝试完成的事情；记录时不会关联调用者，也不会改变答案）。返回一页开放记录，字段与公开网站发布的相同。具名人员、联系渠道、来源列表和核实备注需要订阅。
• get_record — 按注册库 id（由 search_registry 返回）获取一家公司的记录，也可选填同一 purpose 说明。没有订阅密钥时，会返回开放字段，并说明完整记录包含多少个具名职位；提供密钥后，则会返回具名职位、联系渠道、完整来源列表和核实备注。

配置

• FAMILYOFFICEREGISTRY_MCP_URL（可选）— 覆盖上游端点。默认值为 https://familyofficeregistry.com/api/mcp。同时支持别名 FOR_MCP_URL。（此覆盖钩子是本次重建自行添加并明确标注的内容。）
• FAMILYOFFICEREGISTRY_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key> 请求头；同时支持别名 FOR_API_KEY。两者均未设置时，不会发送认证请求头。（此转发机制同样是本次重建自行添加并明确标注的内容；原始功能是在无密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26，clientInfo name officelens），然后发送 notifications/initialized 通知，接着发送携带调用者原始参数的 tools/call 请求。上游通过 Mcp-Session-Id 请求头响应 initialize 时，该值会附加到此会话后续的每个请求中；此会话会在进程运行期间重复使用。回复可能采用纯 JSON 或服务器发送事件格式；两种格式都会读取。

上游的成功结果会原样传递，包括上游设置的任何 isError 标志。失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应，或无法完成的请求——会作为 isError 结果返回，其文本以 officelens error: 开头（此错误呈现方式是本次重建自行添加并明确标注的内容）。

CLI

每个工具也可作为子命令使用，并接收一个 JSON 参数字符串（不需要参数的工具可省略）：

npx @reneturcios/officelens search_registry '{"country":"CH","canton":"ZH","type":"MFO"}'
npx @reneturcios/officelens get_record '{"id":"CHE-116.281.419"}'
npx @reneturcios/officelens --version

退出代码：成功时为 0，返回 isError 结果时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/officelens mcp

MCP 客户端配置：

{
  "mcpServers": {
    "officelens": {
      "command": "npx",
      "args": ["-y", "@reneturcios/officelens", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/officelens
docker run --rm ghcr.io/cloudcorprecords/officelens --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；任何其他参数都会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过一个桩化的 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT — 参见 LICENSE。