236 lines
6.8 KiB
Markdown
236 lines
6.8 KiB
Markdown
# Tao Memory MCP Server (Go)
|
||
|
||
面向 MCP 的“道场记忆”服务：SSE + JSON‑RPC 2.0，支持移动端、异步响应、灵感/日记/周月季半年年炼化与归档剪枝。
|
||
|
||
---
|
||
|
||
## 功能总览
|
||
|
||
- **MCP 协议**：SSE + `/mcp/message` 异步响应（POST 返回 202）
|
||
- **鉴权**：Header Bearer 或 `?token=`
|
||
- **工具体系**：检索、灵感、日记、周/月/季/半年/年总结、归档剪枝、代码巡检提案
|
||
- **存储结构**：六级流转（YEAR/H1|H2/Q/Month/Wxx）
|
||
- **归档剪枝**：月度归档至 `_Archive`，检索默认跳过归档
|
||
|
||
---
|
||
|
||
## 目录结构（六级流转）
|
||
|
||
```
|
||
knowledge_ocean/
|
||
2026/
|
||
H1_Upper/
|
||
Q1/
|
||
03_March/
|
||
W11/
|
||
2026-03-14_Saturday.md
|
||
Week_Summary.md
|
||
Month_Summary.md
|
||
Semiannual_Summary.md
|
||
H2_Lower/
|
||
...
|
||
Year_Summary.md
|
||
Inspirations/
|
||
Idea_1710400000.md
|
||
_Archive/
|
||
2026/03/...
|
||
_Proposals/
|
||
proposal_20260314_150405.md
|
||
```
|
||
|
||
---
|
||
|
||
## MCP 端点
|
||
|
||
- **SSE**：`/mcp/sse?token=...&client=...`
|
||
- **消息**：`/mcp/message?token=...&client=...`
|
||
- **统一入口**：`/mcp` 或 `/mcp/`
|
||
- `GET /mcp` → SSE
|
||
- `POST /mcp` → 自动判定 SSE 或 JSON‑RPC
|
||
|
||
> `client` 用于区分多端连接，避免同一 token 抢占 SSE 通道。
|
||
|
||
**特性：**
|
||
- `POST /mcp/message` 只返回 `202 Accepted`
|
||
- 所有 JSON‑RPC 响应通过 SSE `event: message` 返回
|
||
- CORS 可配置（默认不放行；设置 `TAO_CORS_ORIGINS=*` 才全放开）
|
||
|
||
---
|
||
|
||
## 工具清单
|
||
|
||
### 1) query_memory
|
||
全文检索（默认不搜索归档）
|
||
|
||
- `q` (string)
|
||
- `mode` (exact|causal, 默认 exact)
|
||
- `related_terms` (array<string>) 仅 mode=causal
|
||
- `include_archive` (bool, 默认 false)
|
||
|
||
**causal 输出标注：** `[命中: 关键词]` / `[关联: 关键词]`
|
||
|
||
---
|
||
|
||
### 2) get_week_data / record_summary
|
||
- `get_week_data(weekOffset)`：获取周素材
|
||
- `record_summary(content, weekOffset)`：写入 `Week_Summary.md`
|
||
- 若缺少 `### 📅 时空坐标`，自动套“炼丹笔记”模板
|
||
|
||
---
|
||
|
||
### 3) capture_idea
|
||
捕获灵感并**双写**：
|
||
- 写入 `Inspirations/Idea_*.md`（YAML Frontmatter + tags）
|
||
- 同时写入当天日记（category=idea）
|
||
|
||
参数：
|
||
- `content` (string)
|
||
- `tags` (array<string>, 可选；默认 Unsorted)
|
||
|
||
---
|
||
|
||
### 4) record_daily
|
||
写入当日日记（不会进入灵感库）
|
||
|
||
参数：
|
||
- `content` (string)
|
||
- `karma` (int, 默认 1)
|
||
|
||
---
|
||
|
||
### 5) 月/季/半年/年炼化
|
||
- `get_month_data` / `record_month_summary`
|
||
- `get_quarter_data` / `record_quarter_summary`
|
||
- `get_semiannual_data` / `record_semiannual_summary`
|
||
- `get_year_data` / `record_year_summary`
|
||
|
||
产物：
|
||
- `Month_Summary.md`
|
||
- `Quarter_Summary.md`
|
||
- `Semiannual_Summary.md`
|
||
- `Year_Summary.md`
|
||
|
||
---
|
||
|
||
### 6) housekeep_memory
|
||
归档剪枝（按月）
|
||
|
||
参数：
|
||
- `target_month` (YYYY-MM)
|
||
|
||
逻辑：
|
||
- 校验 `Month_Summary.md` 存在且大小≥100字节且包含 `###`
|
||
- 将该月 `Wxx/` 目录及非 Month_Summary 文件移动到 `_Archive/YYYY/MM/`
|
||
- 生成 `ARCHIVED.txt`
|
||
- `query_memory` 默认跳过 `_Archive`
|
||
|
||
---
|
||
|
||
### 7) inspect_and_propose
|
||
检视代码与灵感，生成补丁建议清单（不自动应用）
|
||
|
||
参数：
|
||
- `repo_path` (可选，默认 `/root/.openclaw/workspace/tao_mcp_go`)
|
||
|
||
行为：
|
||
- `git pull`（需 `TAO_ALLOW_GIT_PULL=true` 才会执行，失败不阻断）
|
||
- `repo_path` 必须在 `TAO_ALLOWED_REPOS` 白名单内
|
||
- 扫描 `Inspirations` 中 `#Todo/#Fix`
|
||
- 生成 `_Proposals/proposal_<timestamp>.md`
|
||
- 当日日记记录摘要
|
||
|
||
---
|
||
|
||
## 配置项（安全建议）
|
||
|
||
- **TAO_AUTH_TOKEN**：必填；不设置则启动失败
|
||
- **TAO_ALLOW_ANON**：是否允许匿名访问（默认 false）
|
||
- **TAO_CORS_ORIGINS**：允许的来源列表，逗号分隔；`*` 为全放开
|
||
- **TAO_DEBUG**：是否输出请求体日志（默认 false）
|
||
- **TAO_SEARCH_ROOT**：检索根目录（必须在 MEMORY_ROOT 下）
|
||
- **TAO_SEARCH_MAX_FILES**：检索文件上限（默认 2000）
|
||
- **TAO_ALLOWED_REPOS**：inspect_and_propose 允许的仓库白名单（逗号分隔）
|
||
- **TAO_ALLOW_GIT_PULL**：是否允许 inspect_and_propose 执行 git pull（默认 false）
|
||
- **TAO_ENDPOINT_TOKEN_ECHO**：若为 true，SSE endpoint 事件会回显 token（用于不带 Header 的客户端；默认 false）
|
||
|
||
---
|
||
|
||
## OpenClaw 接入（示例）
|
||
|
||
**Base URL**
|
||
```
|
||
https://mcp.good.xx.kg
|
||
```
|
||
|
||
**Auth Token**
|
||
```
|
||
YOUR_TOKEN_HERE
|
||
```
|
||
|
||
**Instructions（粘贴）**
|
||
```
|
||
你接入的是 Tao-Memory-Pro MCP。
|
||
|
||
【语义判断（先判类型）】
|
||
- 若内容包含“观点/架构/设计/方案/原理/模型/机制/灵感/idea”，或明显是抽象总结/新想法 → 视为“灵感”
|
||
- 若内容是当天发生的事务、进度、琐事、对话摘录 → 视为“日记”
|
||
- 若内容在请求“总结/复盘/归档/检索” → 视为“操作指令”
|
||
|
||
【优先级规则】从上到下匹配，命中即停止：
|
||
1) “灵感” → capture_idea
|
||
- tags: 自动生成 2~4 个标签
|
||
2) “周总结/本周复盘/weekly” → record_summary
|
||
3) “月总结/月度/monthly” → record_month_summary
|
||
4) “季总结/季度/quarterly” → record_quarter_summary
|
||
5) “半年总结/上半年/下半年/half-year” → record_semiannual_summary
|
||
6) “年度/年报/yearly” → record_year_summary
|
||
7) “归档/清理/剪枝/整理/月度清理” → housekeep_memory（要求 YYYY-MM）
|
||
8) “查找/搜索/回忆/翻找/找一下” → query_memory
|
||
- 提到“历史/很久以前/归档/旧记录” → include_archive=true
|
||
- 提到“关联/因果/相关/对比/溯源” → mode=causal + related_terms
|
||
9) “随手记/日记/今天/记录一下/写一条” → record_daily（karma=1）
|
||
|
||
【冲突处理】
|
||
- 同时满足灵感与日记：优先灵感
|
||
- 同时包含检索与归档：优先问目标月份或关键词
|
||
- 不确定时：先反问澄清，不调用工具
|
||
|
||
【输出风格】
|
||
- 工具调用后只返回结果路径或简短确认，不展开解释
|
||
|
||
【自动标签规则（用于 capture_idea）】
|
||
- 若内容含：MCP/SSE/JSON-RPC/协议 → tags 加 ["协议","MCP"]
|
||
- 若含：AnyTLS/TUIC/QUIC/延迟/带宽 → tags 加 ["网络协议","性能"]
|
||
- 若含：架构/模块/重构/设计 → tags 加 ["架构设计"]
|
||
- 若含：日志/排障/错误/异常 → tags 加 ["故障排查"]
|
||
- 若含：部署/Docker/systemd → tags 加 ["运维部署"]
|
||
- 若含：搜索/索引/向量/检索 → tags 加 ["检索系统"]
|
||
- 若含：安全/鉴权/token → tags 加 ["安全"]
|
||
- 若含：任务/待办/计划 → tags 加 ["待办"]
|
||
若匹配不足 2 个标签，则补充通用标签：["灵感","技术"]
|
||
```
|
||
|
||
---
|
||
|
||
## 编译与运行
|
||
|
||
```bash
|
||
cd /root/.openclaw/workspace/tao_mcp_go
|
||
|
||
go build -o tao-mcp
|
||
./tao-mcp
|
||
```
|
||
|
||
## Systemd
|
||
```bash
|
||
systemctl restart tao-mcp-go
|
||
systemctl status tao-mcp-go
|
||
```
|
||
|
||
---
|
||
|
||
## 备注
|
||
- SSE 已设置 `X-Accel-Buffering: no`
|
||
- MCP 协议版本：`2025-06-18`
|
||
- `TAO_ENDPOINT_STYLE=message` 避免 `/mcp/mcp` 叠加
|