183 lines
3.9 KiB
Markdown
183 lines
3.9 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=...`
|
||
- **消息**：`/mcp/message?token=...`
|
||
|
||
**特性：**
|
||
- `POST /mcp/message` 只返回 `202 Accepted`
|
||
- 所有 JSON‑RPC 响应通过 SSE `event: message` 返回
|
||
- CORS 已放行（含 `OPTIONS`）
|
||
|
||
---
|
||
|
||
## 工具清单
|
||
|
||
### 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`（失败不阻断）
|
||
- 扫描 `Inspirations` 中 `#Todo/#Fix`
|
||
- 生成 `_Proposals/proposal_<timestamp>.md`
|
||
- 当日日记记录摘要
|
||
|
||
---
|
||
|
||
## OpenClaw 接入（示例）
|
||
|
||
**Base URL**
|
||
```
|
||
https://mcp.good.xx.kg
|
||
```
|
||
|
||
**Auth Token**
|
||
```
|
||
a3c60a86ed2a7d317b8855faa94a05d1
|
||
```
|
||
|
||
**Instructions（粘贴）**
|
||
```
|
||
你接入的 MCP 服务器名为 Tao-Memory-Pro。
|
||
调用工具时遵循以下规则：
|
||
1) 重要灵感/架构设计 → 使用 capture_idea（可带 tags）
|
||
2) 日常记录/普通对话 → 使用 record_daily
|
||
3) 周总结使用 record_summary（自动套用炼丹模板）
|
||
4) 检索默认 query_memory；需要查归档时 include_archive=true
|
||
```
|
||
|
||
---
|
||
|
||
## 编译与运行
|
||
|
||
```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` 叠加
|