mcpField
L
LightShip

LightShip

远程服务
lightship.sh数据与分析41 周前更新
代码仓库访问官网

关于 LightShip

LightShip 让领域专家和编码 Agent 调查存储在现有 ClickHouse OpenTelemetry 表中的生产 Agent 轨迹。它在 Web UI、REST API 和 MCP 中统一执行基于角色与属性的策略，不向用户提供数据库凭据。

主要功能

  1. 01受治理的轨迹访问
  2. 02搜索对话、工具调用和结果
  3. 03复用现有 ClickHouse 轨迹数据
  4. 04在 UI、REST 和 MCP 中应用策略
  5. 05提供索引 DDL 建议供审核

适用场景

  1. 01调查生产 Agent 故障
  2. 02向领域专家开放受控轨迹访问
  3. 03将授权调查导出到 Agent 工作区

MCP 相关

MCP 客户端可在与 Web UI 和 REST API 相同的授权策略下查询轨迹。本地 MCP companion 将授权导出写入 Agent 工作区，并仅返回路径和数量。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://lightship-production.up.railway.app/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://lightship-production.up.railway.app/mcp需要授权

工具

详细介绍

LightShip

加快生产环境 Agent 的迭代，摆脱开发人员瓶颈。

CI Release Container License

LightShip 为领域专家提供受治理的生产环境 Agent 跟踪记录自助访问能力。它位于 ClickHouse 中现有的 OpenTelemetry 数据之前，让人员和 AI 编码 Agent 无需数据库凭据，也无需另建可观测性孤岛，即可调查真实对话和工具调用。

文档 · 网站 · 参与贡献

为什么选择 LightShip

  • 找出失败背后的规律。 使用 Codex、Claude 或其他 MCP 客户端，针对对话、工具调用和结果提出业务问题。
  • 保留现有跟踪记录存储。 将 LightShip 绑定到 OpenTelemetry 表，无需将跟踪记录复制到单独的平台。
  • 一次完成检测，之后再定义策略。 选择现有列和属性键作为授权输入，随后即可创建或修改策略，无需重新进行检测。同一策略适用于 Web UI、REST API 和 MCP。
  • 避免大型调查占用模型上下文。 本地 MCP 配套工具会将授权导出内容写入 Agent 工作区，并仅向对话返回路径和计数。

工作原理

  1. 管理员将 LightShip 绑定到 ClickHouse 中现有的 OpenTelemetry span 表。
  2. 管理员选择可用于搜索和访问规则的列及映射键。
  3. LightShip 会在通过 Web UI、REST 或 MCP 返回任何跟踪记录之前，将每个调用者的角色和属性编译进 ClickHouse 查询。

跟踪记录是授权单位：一个匹配的 span 即可授予对完整跟踪记录的访问权限。LightShip 绝不会向受限用户提供 ClickHouse 凭据。

性能

查询性能取决于现有 ClickHouse 跟踪记录表的布局和索引。选好可用于筛选器和访问策略的字段后，LightShip 会检查表的排序键和跳过索引，并针对缺失的索引提供 DDL 建议。这些建议仅供参考：LightShip 绝不会自动更改 ClickHouse 架构。请参阅如何查看优化报告。

快速开始

文档包含持续维护的设置说明和参考资料：

需要帮助在你的环境中部署 LightShip？联系我们。

安全性和项目状态

LightShip 仅保护通过 LightShip 发送的请求。直接访问 ClickHouse 会绕过其策略。目前，它不会检测 PII、编辑载荷或隐藏单个跨度。查询审计尽力而为，因此审计写入失败时会记录日志，但不会导致跟踪请求失败。

LightShip 是一款实验性 Alpha 版本，尚无稳定版本。请在隔离环境中使用合成数据或非敏感数据进行评估。部署前请阅读安全指南和当前限制。

反馈

我们希望帮助让自主工作变得可信且可治理。如果您的团队在生产环境中运行 AI Agent，我们很乐意听取您对 LightShip 后续支持内容的建议。

联系我们或 提交 GitHub 问题。

参与贡献

请参阅 CONTRIBUTING.md 了解开发和测试， 参阅 SECURITY.md 了解漏洞报告方式，并参阅 CHANGELOG.md 了解变更。 LightShip 采用 Apache-2.0 许可证。

评论

支持 Markdown

第一次接触 MCP？

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

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