@hiveforge/hivemind-mcp
Advanced tools
MCP server for Obsidian worldbuilding vaults - provides AI tools with consistent canonical context
A domain-agnostic MCP (Model Context Protocol) server for Obsidian vaults that provides AI tools with consistent, structured context from your knowledge base.
The AI Memory Firewall: Hivemind's core value isn't just better answers — it's preventing AI from inventing context. Your knowledge graph becomes a truth anchor that keeps AI grounded in facts you control.
Hivemind bridges your Obsidian vault and AI tools (Claude, ComfyUI, etc.) via the Model Context Protocol. With pluggable templates, it supports multiple domains out of the box:
Or define your own custom entity types via config.json — no code required.
The canon workflow applies far beyond worldbuilding:
| Domain | What Gets Canon Status |
|---|---|
| Worldbuilding | Approved lore, character facts, timeline events |
| Architecture | Accepted ADRs, design decisions, constraints |
| Brand | Voice guidelines, approved messaging, visual identity |
| Security | Approved policies, access controls, compliance rules |
| People Management | Finalized goals, approved team structures |
AI that references non-canon content gets flagged. AI that violates canon constraints gets corrected. This is governance without meetings.
# Install globally
npm install -g @hiveforge/hivemind-mcp
# Or use with npx (no installation needed)
npx @hiveforge/hivemind-mcp init
# Interactive setup - creates config.json
npx @hiveforge/hivemind-mcp init
# Validate your configuration
npx @hiveforge/hivemind-mcp validate
# Start the server
npx @hiveforge/hivemind-mcp start
# Or start with a specific vault path (no config needed)
npx @hiveforge/hivemind-mcp --vault /path/to/vault
npx @hiveforge/hivemind-mcp --vault . # Use current directory
Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"hivemind": {
"command": "npx",
"args": ["-y", "@hiveforge/hivemind-mcp", "start"]
}
}
}
Claude Desktop with vault override:
{
"mcpServers": {
"hivemind": {
"command": "npx",
"args": ["-y", "@hiveforge/hivemind-mcp", "--vault", "C:\\Path\\To\\Your\\Vault"]
}
}
}
GitHub Copilot (~/.copilot/mcp-config.json):
{
"mcpServers": {
"hivemind": {
"type": "local",
"command": "npx",
"args": ["-y", "@hiveforge/hivemind-mcp", "start"],
"tools": ["*"]
}
}
}
If you prefer to configure manually, create a config.json:
{
"vault": {
"path": "/path/to/your/obsidian/vault",
"watchForChanges": true,
"debounceMs": 100
},
"server": {
"transport": "stdio"
},
"template": {
"activeTemplate": "worldbuilding"
},
"indexing": {
"strategy": "incremental",
"batchSize": 100,
"enableVectorSearch": false,
"enableFullTextSearch": true
}
}
Set activeTemplate to one of the built-in or community templates:
| Template | Use Case | Entity Types |
|---|---|---|
worldbuilding | Fiction writers, game masters | Characters, Locations, Events, Factions, Lore, Assets, References |
research | Academics, knowledge workers | Papers, Citations, Concepts, Notes |
people-management | Managers, team leads | People, Goals, Teams, 1:1 Meetings |
software-architecture | Engineers, architects | Systems, Components, Decisions (ADRs), Constraints, Interfaces |
ux-research | UX researchers, product teams | Interviews, Insights, Hypotheses, Personas, Experiments |
Define custom entity types directly in your config.json:
{
"template": {
"activeTemplate": "my-template",
"templates": [{
"id": "my-template",
"name": "My Custom Template",
"version": "1.0.0",
"entityTypes": [{
"name": "project",
"displayName": "Project",
"pluralName": "Projects",
"fields": [
{ "name": "title", "type": "string", "required": true },
{ "name": "deadline", "type": "date" },
{ "name": "priority", "type": "enum", "enumValues": ["low", "medium", "high"] }
]
}],
"relationshipTypes": [{
"id": "depends_on",
"displayName": "Depends On",
"sourceTypes": ["project"],
"targetTypes": ["project"],
"bidirectional": true,
"reverseId": "blocks"
}]
}]
}
}
See samples/ for complete example vaults for each template.
Create, manage, and validate templates using the command line:
# List available templates (built-in + community)
npx @hiveforge/hivemind-mcp list-templates
# Add a template from the registry, URL, or local file
npx @hiveforge/hivemind-mcp add-template software-architecture
npx @hiveforge/hivemind-mcp add-template https://example.com/template.json
npx @hiveforge/hivemind-mcp add-template ./my-template.json
# Interactive template creation wizard
npx @hiveforge/hivemind-mcp create-template
# Validate a template file
npx @hiveforge/hivemind-mcp validate-template template.json
# Check template compatibility with your Hivemind version
npx @hiveforge/hivemind-mcp check-compatibility
npx @hiveforge/hivemind-mcp check-compatibility software-architecture
# Generate template catalog JSON (for documentation sites)
npx @hiveforge/hivemind-mcp generate-catalog
Want to contribute a template? See CONTRIBUTING_TEMPLATES.md.
Obsidian Vault → File Watcher → Markdown Parser → Knowledge Graph
↓
┌───────────────────┴─────────────────┐
│ │
Full-Text Index Vector Index
(SQLite) (FAISS)
│ │
└───────────────────┬─────────────────┘
↓
HybridRAG Router
↓
MCP Server
↓
AI Clients (Claude, etc.)
Current: v2.1 Community Templates Complete ✅
create-template, validate-template, add-template, list-templatesminHivemindVersionHivemind is now domain-agnostic with pluggable templates:
query_<type>, list_<type>)Tools are automatically generated for each entity type defined in the active template:
| Tool Pattern | Description |
|---|---|
query_<type> | Get entity by ID/name with relationships and content |
list_<type> | List all entities of type with optional filters |
Built-in and community template tools:
| Template | Generated Tools |
|---|---|
worldbuilding | query_character, query_location, query_event, query_faction, query_lore, query_asset, query_reference + list variants |
research | query_paper, query_citation, query_concept, query_note + list variants |
people-management | query_person, query_goal, query_team, query_one_on_one + list variants |
software-architecture | query_system, query_component, query_decision, query_constraint, query_interface + list variants |
ux-research | query_interview, query_insight, query_hypothesis, query_persona, query_experiment + list variants |
| Tool | Description |
|---|---|
search_vault | Hybrid search across all content with type/status filters |
| Tool | Description |
|---|---|
store_asset | Store generated image with provenance metadata |
query_asset | Get asset with generation settings |
list_assets | Filter assets by entity, type, status, workflow |
| Tool | Description |
|---|---|
get_canon_status | List entities grouped by status (draft/pending/canon) |
submit_for_review | Move entity from draft to pending review |
validate_consistency | Check for broken links, duplicates, conflicts |
| Tool | Description |
|---|---|
store_workflow | Save ComfyUI workflow to vault |
list_workflows | Browse saved workflows |
get_workflow | Retrieve workflow by ID |
generate_image | Generate image with vault context injection |
| Tool | Description |
|---|---|
rebuild_index | Force complete re-index of vault |
get_vault_stats | Vault statistics and token savings metrics |
MIT
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Important: This project uses Conventional Commits. Commit messages must follow the format:
<type>: <description>
[optional body]
[optional footer]
Common types: feat, fix, docs, style, refactor, test, chore
Example: feat: add pagination support to search results
FAQs
MCP server for Obsidian worldbuilding vaults - provides AI tools with consistent canonical context
The npm package @hiveforge/hivemind-mcp receives a total of 8 weekly downloads. As such, @hiveforge/hivemind-mcp popularity was classified as not popular.
We found that @hiveforge/hivemind-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Research
/Security News
A Twitch browser extension on Chrome and Firefox forwards users’ live OAuth session tokens through proxies controlled by a Russian bot service.
Security News
Anthropic found biased reasoning and recklessness drove Claude Mythos 5 to publish malware on PyPI and compromise a security vendor.
Research
/Security News
Malicious Chrome and Firefox extensions target Axiom Trade and Padre users, stealing session tokens and wallet data.