代码库遍历工具

一个基于MCP服务器的代码库遍历工具,可将代码库分解并生成可视化图表,支持本地和共享服务器部署。

  • by taciturnaxolotl
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 taciturnaxolotl/traverse

使用说明

遍历

[!注意] 此规范仓库托管在纠结的 dunkirk.sh/traverse

我最喜欢的功能之一是 安培 是他们的漫游功能。它运行一个子代理,该子代理将您的仓库分解为多个部分,然后将其发送到amp的服务,以呈现为一个漂亮的网页!我很好奇,最终放弃了漫游子代理和生成图表的工具提示。

事实证明,他们使用的是mermaid语法,每个节点上的id都链接到一个json对象,该对象以md表示每个部分的摘要。通过研究他们的网络用户界面渲染,他们实际上设计了自己的美人鱼渲染器,可能会获得更好的路径路由。我们可以用普通的美人鱼来惊人地接近它,这就是这个项目!

这是一个mcp服务器,它也在后台启动一个web服务器。你可以将其连接到任何你想要的支持mcp的ai工具中(如果不是接近100%,目前已经超过了80%的编码工具),并开始生成演练!它最初会给你一个本地url,但如果你想与他人共享,那么你可以使用页面上角的共享按钮,默认情况下,它会将其共享到我的托管实例 traverse.dunkirk.sh 但是,如果您配置json设置或添加env变量,则可以将其指向您自己的自托管实例!

我们试试吧!

mcp服务器必须使用bun运行,因为它使用 Bun.serve api广泛。如果你还没有尝试过包子,我强烈推荐它!

bunx @taciturnaxolotl/traverse@latest

默认情况下,这将在stdio上运行MCP服务器,在 localhost:4173.

我希望这个在我选择的经纪人身上!

对于claude代码,他们让这变得相当容易:

claude mcp add traverse -- bunx @taciturnaxolotl/traverse@latest

对于claude桌面(在mac上),您可以添加以下内容 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "traverse": {
      "command": "bunx",
      "args": ["@taciturnaxolotl/traverse@latest"]
    }
  }
}

对于其他代理,其JSON配置通常相同。

配置

在macos上编辑/创建 ~/Library/Application Support/traverse/config.json如果你使用的是Linux ~/.config/traverse/config.json (或 $XDG_CONFIG_HOME/traverse/config.json)

{
  "shareServerUrl": "https://traverse.dunkirk.sh",
  "port": 4173,
  "mode": "local"
}

作为替代或补充,您可以使用env-vars来定义相同的选项:

var 默认值 描述
TRAVERSE_PORT 4173 web服务器端口
TRAVERSE_MODE local local (mcp+web)或 server (仅限网络)
TRAVERSE_SHARE_URL https://traverse.dunkirk.sh 共享服务器url
TRAVERSE_DATA_DIR 平台默认值 sqlite数据库位置

© 2026-present Kieran Klukas