Code Trajectory MCP

MCP开发工具

提供方 RataToaster

开发工具 未标注 无需鉴权 社区 / 第三方

Code Trajectory MCP是一款为大型语言模型(LLM)提供持久化代码历史记忆的服务,通过跟踪代码演变实现跨AI会话的上下文保持。

一句话选型结论

按资料字段整理

Code Trajectory MCP 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

AI编程辅助Python本地部署代码历史跟踪会话连续性开发流程优化Git集成

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Code Trajectory MCP当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方RataToaster上游标注的维护方 RataToaster
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.8 KB
来自项目仓库与上游目录的原文,未做删改

代码轨迹MCP服务器

> 在AI会话中保持你的编码势头。
>
> 将“基于状态”的编码转变为“基于流”的开发。

代码轨迹MCP 是一个模型上下文协议(MCP)服务器,它为大型语言模型(LLM)提供了编码历史的持久内存。它追踪 进化 在影子存储库中存储代码,允许您切换AI聊天会话,而不会丢失您的势头、架构意图或最近决策的上下文。


🚀 为什么是代码轨迹?

问题:“新会话失忆症”

每个使用LLM的开发人员都知道这场斗争:

  1. 上下文溢出: 你正处于深度编码流程中,但聊天时间太长了。LLM速度减慢或达到令牌限制。
  2. 强制重置: 你必须开始一个 新聊天.
  3. 上下文丢失: 新的人工智能会话对你最后2个小时的工作一无所知。你浪费时间重新解释: “我正在重构登录…还记得我们决定使用JWT吗?”

解决方案:持续的动力

代码轨迹 充当人工智能的外部“海马体”(长期记忆)。

  • 之前: AI只看到代码的原样 现在.
  • 使用代码轨迹: AI看到 如何 代码的演变和 哪里 你中断了。
    > “我看到你正在迁移 auth.py 在上一届会议上,OAuth2。我会在你停下来的地方继续。”

✨ 主要特点

1.♾️ 会话连续性

这是核心超级大国。当您开始新的聊天时,AI可以查询此MCP以检索您的聊天摘要 最近的轨迹。它弥合了不连贯的聊天会话之间的差距,确保您的架构决策在“新聊天”按钮后仍然有效。

2.⚡ 自动阴影快照

后台文件监视器会自动在 隐藏影子git存储库 (.trajectory)每当您保存文件时。

  • 零污染: 你的主要项目 git 历史是干净的。
  • 全粒度: 每次保存都会被记录下来,允许AI分析您的试错过程。

3.🌊 “流动”意识

当前的LLM就像GPS一样工作,它知道你的位置,但不知道你的速度。此工具提供 向量:

  • get_file_trajectory:将文件历史记录转换为叙述性故事(过去->现在)。
  • get_global_trajectory:分析一个文件中最近的更改如何影响其他文件的“涟漪效应”。

4.🎯 意图和噪声过滤

  • 意图记录: 您可以明确地告诉系统: “我正在重构Auth系统。” 在更改之前,此意图将标记到所有后续快照。
  • 智能整合: 这 consolidate 当任务完成时,该功能将嘈杂的“试错”快照压缩为干净、有意义的历史点。

🛠️ 技术栈

  • 运行时间: Python 3.14+
  • 包管理器: 紫外线 (快速Python包安装程序)
  • 核心库: mcp, gitpython, watchdog

📦 安装和设置

1.先决条件

确保你有 uv 安装:```bash
curl -LsSf https://astral.sh/uv/install.sh | sh


### 2.项目设置

确保目标项目是一个git存储库(MCP使用它来root自己,尽管它将数据存储在 `.trajectory`).```bash
cd /path/to/your/project
git init

3.配置您的AI客户端

  • 克劳德桌面: claude_desktop_config.json
  • 光标/IDE: settings.json (或“MCP服务器”配置)```json
    "mcpServers": {
    "code-trajectory": {
    "command": "uvx",
    "args": [
    "--from",
    "git+https://github.com/SynTaek/code-trajectory-mcp.git",
    "code-trajectory-mcp"
    ]
    }
    }

### 4.设置AI说明(推荐)

为了确保AI自主有效地使用Code Trajectory,您必须为其提供操作指南。

1. 复制的完整内容 **`AGENT_GUIDE.md`** 从这个存储库。
1. 将其粘贴到AI的自定义指令或系统提示中:
- **光标:** 创建或附加到 `.cursorrules` 项目根目录中的文件。
- **克劳德项目:** 添加到“项目说明”。
- **一般法学硕士:** 添加到“系统提示”或“自定义说明”中。

> **提示:** 本指南指导人工智能何时查询轨迹以及如何整合历史,确保其作为主动的编码合作伙伴。

______________________________________________________________________

## 🤖 代理工作流程指南

充分利用 **代码轨迹**,遵循此工作流程。它确保您的AI上下文在会话中保持不变。

### 步骤1:初始化(新会话)

当你开始一个 **新聊天**,始终以以下内容开头:

1. **配置:** 呼叫 `configure_project(path="/path/to/project")`.
1. **还原上下文:** 呼叫 `get_session_summary()` 或 `get_global_trajectory()`.
- *结果:* AI下载您上一次会话的“记忆”(例如。, *“上次编辑是在5分钟前 `User.ts`,目的是“修复API错误”*).

### 第二步:工作循环

1. **设定意图:** `set_trajectory_intent("Implementing Dark Mode")`
- *为什么?* 这会标记每个保存有此目标的文件,使历史具有语义。
1. **工作:** 您或AI编辑文件。服务器自动快照 `[AUTO-TRJ]` 在背景中。

### 步骤3:整合(任务完成)

1. **巩固:** `consolidate("Completed Dark Mode implementation")`
- *为什么?* 这将把混乱的中间保存清理到一个清晰的历史节点中,为 *下一个* 会议。

______________________________________________________________________

## 📊 可视化你的动力

自从 `.trajectory` 是一个标准的Git存储库,您可以使用标准工具可视化您的“思维过程”。

- **VSCode:** 打开 `.trajectory` 在新窗口中创建文件夹并使用 **Git图形**.
- **终端:**```bash
# View the narrative log
git --git-dir=.trajectory/.git log --graph --oneline --all

📄 许可证

麻省理工学院

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Code Trajectory MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Code Trajectory MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Code Trajectory MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Code Trajectory MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Code Trajectory MCP 能提供哪些能力?

资料显示能力标签包括 AI编程辅助、Python、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。