KSJ MCP服务器
知识综合期刊v2.0——人工智能伴侣
将你的手写日记照片变成一个可搜索的、由人工智能驱动的知识库——私下里,在你自己的机器上。
> “在纸上效果很好。用人工智能很神奇。”
获取日志: 亚马逊知识综合期刊v2.0
它做什么
KSJ MCP服务器通过 模型上下文协议(MCP) --将人工智能模型链接到本地工具和数据的开放标准。
物理日志→ 知识库
拍摄日记页面,上传,你的人工智能助手可以:
- 搜索你写过的所有东西
- 查找想法之间的联系(共享标签,
@参考文献 - 提出你的未决问题、关键见解和突破
- 将您的知识库导出为Markdown或JSON格式
人工智能研究会议→ 结构化见解
花一个小时与人工智能助手深入探讨一个话题,聊天结束后,大部分想法都消失了。 extract_ai_insights 修复了粘贴或管道会话记录,服务器提取重要内容的问题:
- 新颖的假设和种子思想
- 概念之间的意外联系
- 值得探讨的开放性问题
- 作出的决定和行动项目
每个见解都有信心评分(🟢 种子/🔴 开发/🟡 Strong),并在将任何内容写入数据库之前显示给您查看。批准的条目与您的日志捕获一起存储,并提供完整的标签支持,因此AI提取的见解与您的手写笔记一起出现在搜索、连接图和合成建议中。
所有处理都是本地的。 你的笔记留在你的机器上。
AI平台支持
此服务器使用 MCP(模型上下文协议),这是一个开放标准,在人工智能平台和开发工具上得到了越来越多的支持。
目前支持:
- 克劳德桌面版 (免费)--完全支持MCP,建议初学者使用
其他MCP兼容客户端 (Cursor、VS Code+GitHub Copilot等)可以使用相同的配置进行连接——有关设置的详细信息,请查看客户端的MCP文档。
使用ChatGPT、Gemini或其他平台?
使用 export_captures 该工具将您的知识库转储为Markdown或JSON,然后将其粘贴到您选择的AI助手中。随着生态系统的发展,对其他平台的完全原生MCP支持正在规划中。
设置(4个步骤)
步骤1--安装兼容MCP的AI客户端
最快的开始方式是 克劳德桌面版 (免费在claude.ai/下载)。
对于其他MCP客户端,请参阅其文档以了解如何注册本地MCP服务器,然后使用步骤4中的配置。
步骤2--安装Tesseract OCR
Tesseract从你的日记照片中读取文本。它必须单独安装。
| 平台 | 命令 |
|---|---|
| 视窗 | 从下载安装程序 UB曼海姆/镶嵌 --在安装过程中选中“添加到PATH” |
| macOS | brew install tesseract |
| Linux | sudo apt install tesseract-ocr |
安装后,重新启动AI客户端,以获取更新的PATH。
> Windows注意事项: 如果跳过“添加到PATH”,服务器仍将在默认安装位置自动检测Tesseract(C:\Program Files\Tesseract-OCR\).建议添加到PATH,但不是必需的。
步骤3--安装uv和KSJ服务器
紫外线 是一个用于安装和运行KSJ服务器的快速Python包管理器。
安装紫外线:
平台 · 命令
视窗 · winget install astral-sh.uv 或 从astral.sh/uv下载
macOS/Linux · curl -LsSf https://astral.sh/uv/install.sh \ · sh
证实 uv --version 在继续之前,请先在终端中。
安装KSJ服务器 (在终端中运行一次):```
uv tool install --from git+https://github.com/ChavezAILabs/ksj-mcp ksj-mcp
这将安装 `ksj-mcp` 作为您计算机上的持久命令。此步骤必须安装Git(Windows: Windows 版 Git).
证实 `ksj-mcp --help` --如果显示帮助消息,则安装成功。
**稍后更新:**```
uv tool upgrade ksj-mcp
步骤4——注册服务器
Claude桌面配置文件位置:
| 平台 | 路径 |
|---|---|
| 视窗 | %APPDATA%\Claude\claude_desktop_config.json |
| macOS/Linux | ~/.config/claude/claude_desktop_config.json |
添加以下块:```json
{
"mcpServers": {
"ksj": {
"command": "ksj-mcp"
}
}
}
保存并重新启动您的AI客户端。你应该看看 **卡索斯岛机场** 列在工具/集成面板中。
______________________________________________________________________
## 用法
连接后,自然地与您的AI助手交谈。
**上传:**
> “从/Users/me/Desktop/RC-001.jpg上传我的日记照片”
> “处理我的/桌面/日记扫描文件夹中的所有照片”
**搜索和浏览:**
> “在我的笔记中搜索关于间隔重复的想法”
> “显示所有标记为#机器学习的内容”
> “我对微积分的开放性问题是什么?”
> “显示连接到RC-015的所有内容”
**综合与审查:**
> “我准备将哪些主题合成到SYN页面中?”
> “显示我的突破时间表”
> “我对线性代数的理解进展如何?”
**梦想捕捉:**
> “什么符号和主题一直出现在我的梦中?”
> “显示我本月的所有梦想条目”
**出口与健康:**
> “将所有标记为#ai的捕获导出为Markdown”
> “根据我的开放式问题生成学习板”
> “我的日记练习怎么样了?”
______________________________________________________________________
## 可用工具
### 日记工具
|工具|它做什么|
|------|-------------|
| `upload_capture` |OCR日志照片,解析模板,存储,突出显示最强连接|
| `bulk_upload` |一次处理整个文件夹的照片|
| `search_captures` |带有可选标签和日期过滤器的全文搜索|
| `list_by_tag` |浏览具有给定标签或前缀的所有捕获|
| `find_connections` |显示标签重叠和 `@`-捕获的参考连接|
| `get_stats` |概述:计数、热门标签、开放式问题、见解、日期范围|
| `export_captures` |将你的知识库转储为Markdown或JSON|
| `suggest_synthesis` |查找准备成为SYN条目的RC主题集群|
| `export_study_deck` |出口 `?` 将问题作为便携式CSV学习平台(Anki、Quizlet、Notion等)|
| `journal_health` |KPI仪表板+辅导:速度、综合比率、复习节奏、开放式问题|
| `get_breakthroughs` |所有SYN条目按时间顺序排列——您的完整突破时间表|
| `dream_patterns` |DC页面上反复出现的符号、情感、主题和主题|
| `knowledge_progress` |轨道需要工作→ 固体→ 掌握REV参赛作品的进展|
### AI会话工具
|工具|它做什么|
|------|-------------|
| `extract_ai_insights` |从人工智能研究会议记录中提取信心得分的见解——在编写任何数据库之前进行用户审查|
______________________________________________________________________
## 模式标签系统
在日志页面的任何位置使用这些前缀——服务器会自动提取它们。
**RC、SYN、REV页面:**
|前缀|含义|示例|
|--------|---------|---------|
| `#` |主题/领域| `#machine-learning` |
| `@` |来源/参考| `@RC-012` |
| `!` |优先级/紧迫性| `!deadline` |
| `?` |未决问题| `?why-does-this-work` |
| `$` |关键见解| `$breakthrough` |
| `A→B` |因果关系| `study→retention` |
**DC(梦想捕捉)页面** 使用特定于梦境的变体:
|前缀|含义|示例|
|--------|---------|---------|
| `#` |梦想主题| `#flying` |
| `@` |符号或字符| `@the-old-house` |
| `!` |反复出现的主题| `!falling` |
| `*` |感官细节| `*cold-wind` |
______________________________________________________________________
## 故障排除
**“未安装Tesseract OCR”**
安装Tesseract(上述步骤2)并重新启动AI客户端。
**“无法检测模板ID”**
确保模板编号(RC-001、SYN-001等)在照片中清晰可见。尝试更好的照明或更近的拍摄。
**“RC-001已存在于您的知识库中”**
您正在重新上传已存储的页面。要用新照片替换它(例如,在更清晰地重新拍摄后),请让您的AI助手上传 `force=True`:
> “上传/path/to/RC-001.jpg,强制为True”
**“服务器传输意外关闭”/服务器未启动**
跑 `ksj-mcp --help` 在终端中。如果这有效,问题出在Claude Desktop配置上——请仔细检查它是否是有效的JSON `"command": "ksj-mcp"`.如果 `ksj-mcp` 如果找不到,请从步骤3重新运行install命令。
**服务器未出现在工具面板中**
确认 `ksj-mcp --help` 在终端中工作,验证配置文件是有效的JSON,并在保存任何配置更改后重新启动Claude Desktop。
______________________________________________________________________
## 数据位置
您的所有捕获都存储在本地 `~/.ksj-mcp/`:
|平台|路径|
|----------|------|
| **视窗** | `C:\Users\\.ksj-mcp\` |
| **macOS/Linux** | `~/.ksj-mcp/` |
**文件夹:**```
~/.ksj-mcp/captures.db (SQLite database — all your captures and tags)
~/.ksj-mcp/images/ (copies of uploaded journal photos)
您的数据永远不会发送到任何地方,并在更新过程中持续存在。
自定义位置: 设置 KSJ_DATA_DIR 配置中的环境变量,用于在其他地方存储数据:json
{
"mcpServers": {
"ksj": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ChavezAILabs/ksj-mcp", "ksj-mcp"],
"env": {
"KSJ_DATA_DIR": "C:\\Users\\you\\Documents\\ksj-data"
}
}
}
}
许可证
MIT-免费使用、修改和共享。
由...创建 查韦斯人工智能实验室有限责任公司
paul@chavezailabs.com
“人工智能时代的个人知识操作系统”
获取日志: 知识综合杂志v2.0 (亚马逊)
