侧上下文mcp
在本地开发中的“要做的事情笔记”LLM一种小的上下文服务器,用于在代理和人之间安全共享。
- 在其他地方管理不想进入存储库的“做的事情笔记”和思考日志
- LLM“当前条目状态和上下文参考信息”
- 对于人类来说,实时监视“LLM现在在做什么”“关注什么”的窗口
目标是“开发现场笔记”git / PR / Issue 不要弄脏,但是可以在代理和人类之间共享。
背景 / Motivation
在通常的开发流程中,最近的验证笔记和“下次做这个”等粗枝大叶的事情笔记经常存在于本地的笔记和头脑中。
只是LLM想让他帮忙开发的话会出问题:
- LLM希望大家经常知道“现在在做什么”“什么是拦网”
- 但是,如果用存储库中的文件管理它的话…
- git即使是未追踪的文件LLM随便,随便PR啊Issue言及 - .gitignore 如果你把它放进去LLM无法读取那个文件
- 而且,中途经过的笔记也有很多不是想给其他成员看的内容(愚蠢的试行错误、工作循环、“总之就是这样”等)
side-context-mcp 的目标是很好地分离这里。
- 将开发中要做的事情笔记/思考日志保存在存储库外
- 那个LLM 中所述修改相应参数的值
- 而且,人类也可以实时监视它
因此:
- LLM和人类在“现在在做什么”上没有偏差
- PR啊Issue的范围
- 但是本地的思考日志不会泄漏git保持
详细规格 docs/system_design.md 来修改标记元素的显示属性。
安装和运行
- 安装相关性
pnpm install- TypeScript 构建
pnpm build- CLI 执行
构建后,可以在存储库正下方执行以下操作:。
node dist/bin/side-context-mcp.js [options]Codex 注册示例
Codex 的,之 config.toml 中添加以下条目MCP 可以作为服务器使用。路径适合您的环境 ~/side-context-mcp/dist/bin/side-context-mcp.js 的明细栏样式中定义的设置。
[mcp_servers.side_context]
command = "node"
args = [
"/path/to/side-context-mcp/dist/bin/side-context-mcp.js",
"server"
]
# データ保存先を変えたい場合は環境変数で指定できます
# env = { SIDE_CONTEXT_MCP_HOME = "/path/to/storage" }Codex 重新启动 side_context 注册为服务器createEntries 啊 listEntries 等已弃用的函数的缺少的支持。
CLI 使用方法
side-context-mcp 除了服务器启动之外,还可以使用子命令进行存储操作。
# 既定のサーバー起動(従来通り)
side-context-mcp
# サーバーを明示的に起動
side-context-mcp server --transport stdio
# やることエントリを追加
side-context-mcp create --title "朝会メモ" --note "共有事項を追記する"
# 一覧表示(完了済みを含める)
side-context-mcp list --include-done --format table
# アクティブエントリの切り替えと確認
side-context-mcp active set entry_00012
side-context-mcp active show
# メモ&ステータス更新
side-context-mcp update entry_00012 --note "レビュー待ち" --status doing
# エントリ削除
side-context-mcp delete entry_00010 entry_00011通用选项:
- `--home
: SIDE_CONTEXT_MCP_HOME` 中所述修改相应参数的值。
--json:将输出格式设置为JSON 固定(list啊active show来修改标记元素的显示属性。
CLI 啊 SIDE_CONTEXT_MCP_HOME 中描述的相应参数的值 ~/.side-context-mcp 中所述修改相应参数的值。
环境变数
SIDE_CONTEXT_MCP_HOME
- 设置为想要更改数据保存位置的情况。 - 未设定或空字符时 ~/.side-context-mcp 将条目添加到文档注册表。
