🌌 Holosophy-MCP · 全息玄学 MCP 服务 将跨学科知识图谱转化为可计算的语义接口，为 AI Agent 赋予东方智慧。

📖 这是什么？ Holosophy-MCP 是 HoloSophy 知识图谱的 MCP（Model Context Protocol）服务端实现。

它将玄学 · 量子力学 · 天文学 · 历史地理四域知识，通过标准化的 API 对外提供服务，让任何 AI 应用都能以统一的语义协议调用这个知识库。

知识图谱 → 可计算接口 → AI 可调用

🔗 与 HoloSophy 的关系 项目 角色 说明 holosophy 知识层 Obsidian 知识图谱，人类可读的跨学科知识 holosophy-mcp 接口层 将知识转化为 API，机器可读、AI 可调用 EAHub 展示层 知识图谱的可视化前端界面 三者构成完整闭环：知识沉淀 → API 服务 → 交互呈现

🌐 线上服务

组件	地址
API 服务	https://mcp.eastastar.com
展示前端	https://hub.eastastar.com
前端仓库	https://github.com/vfvincentwong2026/eahub

数据：Cloudflare D1（concepts 70 条 / relationships 899 条，由 holosophy Obsidian 知识库导入），CORS 已全开，任意前端可直接调用。

🧠 核心能力 语义检索：基于自然语言的跨域知识搜索

关联查询：自动发现概念之间的隐性关联

Agent 就绪：标准 MCP 协议，可直接接入 Claude Desktop 等 Agent 工具

Cloudflare 原生：基于 Workers + D1，全球节点毫秒级响应

🚀 快速开始 bash git clone https://github.com/vfvincentwong2026/holosophy-mcp.git cd holosophy-mcp npm install --legacy-peer-deps npx wrangler dev --remote --port 8787 bash curl http://127.0.0.1:8787/health

返回 {"status":"ok"}

🔄 知识库同步（Obsidian → D1）

在 Obsidian 知识库新增/修改笔记后，一条命令同步到线上：

python scripts/import.py            # 全量同步（幂等：清库重灌，自动分批）
python scripts/import.py --dry-run  # 只解析+统计，生成 import_preview.sql 不写库

• 知识库路径：默认脚本内 DEFAULT_VAULT，可用 --vault "路径" 或环境变量 HOLOSOPHY_VAULT 覆盖
• 分类自动发现：vault 根目录下新增含 .md 的目录即成为新分类（copilot / .obsidian 等已排除），知识库可以不断生长
• frontmatter 的 title / tags / 摘要 与正文 [[wikilink]] 双链都会被解析入库；重名笔记自动去重并提示
• 依赖：仅 Python 3.8+ 标准库；wrangler 自动定位（仓库 node_modules 优先）

📚 API 端点 端点 方法 说明 /health GET 健康检查 /api/knowledge/search?q={query} GET 语义搜索知识 /api/knowledge/add POST 添加知识节点 /mcp POST MCP 标准对话接口 🧩 Agent 接入示例（Claude Desktop） json { "mcpServers": { "holosophy": { "command": "npx", "args": ["-y", "wrangler", "dev", "--remote", "--port", "8787"] } } } 🛠 技术栈 Hono — Web 框架

Cloudflare Workers — 部署运行时

Cloudflare D1 — SQLite 数据库

TypeScript — 类型安全

MCP Protocol — Agent 通信标准

📄 License MIT © vfvincentwong

让东方智慧以可计算的方式进入 AI 时代。