内容
# Sage MCP 服务器
思想旅程的反思伴侣。Sage 是一个 MCP（模型上下文协议）服务器，帮助您通过新兴的、根茎式的结构捕捉、探索和连接您的反思。
## 哲学
Sage 体现了蒂姆·英戈尔德（Tim Ingold）的“**旅行**”概念：知识通过运动和探索产生，而不是预先确定的类别。路径在行走中自我创造。
### 关键原则
- **有机涌现**：标签和连接通过使用自然形成，而不是预先强加
- **根茎结构**：任何反思都可以与任何其他反思以任何方向、任何原因连接
- **上下文和体现**：反思不仅捕捉思想，还捕捉上下文——当前紧迫的事情，驱动探索的必要性
- **递归增长**：反思成为未来反思的资源；结构为思考生成新的可能性
查看 `project_vision/vision.md` 以获取完整的哲学基础。
## 功能
- **反思会话**：与 Sage 的时间戳对话，用于深化个人探索
- **全文搜索**：按内容或标签查找过去的反思
- **新兴标签**：在主题通过使用形成时标记它们
- **根茎连接**：在反思之间创建路径
- **路径导航**：探索涌现的想法网络
## 安装
1. 克隆此仓库
2. 创建虚拟环境：
```bash
python3 -m venv .venv
source .venv/bin/activate # 在 Windows 上：.venv\Scripts\activate
```
3. 安装依赖项：
```bash
pip install -r requirements.txt
```
## 配置
将以下内容添加到您的 MCP 设置（例如，Claude Desktop 配置）中：
```json
{
"mcpServers": {
"sage": {
"command": "python3",
"args": ["/path/to/lagrieta_mcp/server.py"]
}
}
}
```
## 可用工具
### `sage_reflect`
分享经验、想法、感受或瞬间。Sage 以温和的好奇心回应，以深化探索。
**参数：**
- `text`（字符串）- 您想要反思的内容
### `sage_start_session`
开始新的反思会话。检索最近的会话以提供连续性。
### `sage_end_session`
将当前会话保存到数据库。
**参数：**
- `session_content`（字符串）- 要保存的完整对话
### `sage_search`
通过内容或标签搜索反思。
**参数：**
- `query`（字符串）- 搜索文本，或以 `#` 前缀的标签名称（例如，`#wayfaring`）
- `limit`（整数，可选）- 最大结果数（默认值：10）
**示例：**
```
sage_search("embodiment") # 按内容搜索
sage_search("#wayfaring") # 按标签搜索
```
### `sage_tag`
为会话添加标签以标记新兴主题。
**参数：**
- `session_id`（整数）- 要标记的会话
- `tags`（字符串数组）- 要添加的标签（例如，`["wayfaring", "language"]`）
### `sage_connect`
在两个会话之间创建根茎连接。
**参数：**
- `from_session_id`（整数）- 起始会话
- `to_session_id`（整数）- 目标会话
- `connection_type`（字符串，可选）- 连接性质（例如，"resonance", "elaboration", "contrast"）
- `note`（字符串，可选）- 连接说明
**建议的连接类型：**
- `resonance` - 回响和强化的主题
- `elaboration` - 一个想法扩展另一个想法
- `contrast` - 想法之间的生产性紧张
- `echo` - 不同上下文中的相似模式
- `recursion` - 自身循环的想法
### `sage_explore`
导航根茎路径。
**参数：**
- `session_id`（整数，可选）- 要从中探索的会话；省略以获取概览
**两种模式：**
1. **带 session_id**：显示该点的标签和连接会话
2. **不带 session_id**：显示整个根茎的概览
## 数据库结构
Sage 使用 SQLite 存储反思，模式设计用于有机增长：
- **sessions** - 时间戳反思对话
- **reflections** - 带有上下文的单个反思条目
- **tags** - 新兴主题和概念
- **reflection_tags** - 多对多标签关联
- **connections** - 反思之间的根茎路径
您添加的每个反思、标签和连接都会使数据库变得更有价值和相互关联。
## 开发
会话笔记和实现细节在 `llm_auto_coding/` 中跟踪。
## 架构
- `server.py` - MCP 服务器实现与工具处理程序
- `database.py` - SQLite 操作和数据模型
- `reflections/` - 数据库和任何导出文件的存储
- `project_vision/` - 哲学基础和设计原则
## 根茎生长
结构不会限制思维——它从思维中产生。开始反思，注意主题，发现连接，观察路径在您脚下形成。
**这就是旅行。**
