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 |
添加以下块：
{
"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 配置中的环境变量，用于在其他地方存储数据：
{
"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 （亚马逊）