🌌 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 知识库新增/修改笔记后，一条命令同步到线上：

```bash
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 时代。