Content
# Holosophy-MCP · Holographic Metaphysics MCP Service
Transform interdisciplinary knowledge graphs into computable semantic interfaces, empowering AI Agents with Eastern wisdom.
## What is this?
Holosophy-MCP is the MCP (Model Context Protocol) server-side implementation of the HoloSophy knowledge graph.
It provides a standardized API to expose the knowledge of metaphysics, quantum mechanics, astronomy, and historical geography, allowing any AI application to call this knowledge base using a unified semantic protocol.
Knowledge Graph → Computable Interface → AI Callable
## Relationship with HoloSophy
| Project | Role | Description |
| --- | --- | --- |
| holosophy | Knowledge Layer | Obsidian knowledge graph, human-readable interdisciplinary knowledge |
| holosophy-mcp | Interface Layer | Converts knowledge into API, machine-readable, AI callable |
| EAHub | Presentation Layer | Visualized frontend interface of the knowledge graph |
The three components form a complete closed loop: knowledge sedimentation → API service → interactive presentation.
## Core Capabilities
- Semantic search: cross-domain knowledge search based on natural language
- Associative query: automatically discover implicit associations between concepts
- Agent readiness: standard MCP protocol, directly accessible to agent tools like Claude Desktop
- Cloudflare native: global node millisecond-level response based on Workers + D1
## Quick Start
```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
# Returns {"status":"ok"}
```
## API Endpoints
| Endpoint | Method | Description |
| --- | --- | --- |
| /health | GET | Health check |
| /api/knowledge/search?q={query} | GET | Semantic search knowledge |
| /api/knowledge/add | POST | Add knowledge node |
| /mcp | POST | MCP standard conversation interface |
## Agent Access Example (Claude Desktop)
```json
{
"mcpServers": {
"holosophy": {
"command": "npx",
"args": ["-y", "wrangler", "dev", "--remote", "--port", "8787"]
}
}
}
```
## Tech Stack
- Hono — Web framework
- Cloudflare Workers — Deployment runtime
- Cloudflare D1 — SQLite database
- TypeScript — Type safety
- MCP Protocol — Agent communication standard
## License
MIT © vfvincentwong
Let Eastern wisdom enter the AI era in a computable way.
