README.md
Build knowledge graphs with AI.
Graforest MCP Server
Build knowledge graphs with AI. 13 tools for creating, populating, searching, and exploring knowledge graphs through the Model Context Protocol.
What Is This?
Graforest MCP lets AI agents (Claude, Cursor, VS Code, etc.) build and query knowledge graphs. No database setup. No Neo4j config. Just tell your AI agent what you want to know.
"Create a knowledge graph about organic chemistry and populate it from my notes"
→ 2 minutes later: Searchable knowledge graph with entities and relationships
The AI agent handles intelligence (entity extraction, reasoning). Graforest handles data (storage, search, traversal).
Installation
pip install graforest-mcp
Quick Start
1. Get Your API Key
Visit graforest.ai/settings and create an API key (gf_sk_...).
2. Configure Your AI Agent
VS Code — Add to .vscode/mcp.json:
{
"servers": {
"graforest": {
"command": "uvx",
"args": ["graforest-mcp"],
"env": {
"GRAFOREST_API_KEY": "gf_sk_your_key_here"
}
}
}
}
Cursor — Add to .cursor/mcp.json:
{
"mcpServers": {
"graforest": {
"command": "uvx",
"args": ["graforest-mcp"],
"env": {
"GRAFOREST_API_KEY": "gf_sk_your_key_here"
}
}
}
}
Claude Desktop — Add to claude_desktop_config.json:
{
"mcpServers": {
"graforest": {
"command": "uvx",
"args": ["graforest-mcp"],
"env": {
"GRAFOREST_API_KEY": "gf_sk_your_key_here"
}
}
}
}
Smithery:
npx @smithery/cli install @graforest/mcp
13 Tools
Provisioning (3 tools)
| Tool | Description |
|---|---|
create_knowledge_project |
Provision a new knowledge graph (Neo4j) |
list_knowledge_projects |
List all graph projects |
delete_knowledge_project |
Delete a graph project permanently |
Data Write (2 tools)
| Tool | Description |
|---|---|
add_knowledge_nodes |
Bulk create entities (max 500/batch) |
add_knowledge_relationships |
Bulk create relationships (max 500/batch) |
Data Read (6 tools)
| Tool | Description |
|---|---|
search_knowledge_graph |
Full-text search across all node fields |
get_knowledge_schema |
Get entity types, relationship types, and fields |
get_knowledge_statistics |
Node and relationship counts by type |
traverse_knowledge_graph |
Walk connections from any node |
list_knowledge_entities |
List entities by type (paginated) |
get_knowledge_entity |
Get a single entity by ID |
Ingestion (1 tool)
| Tool | Description |
|---|---|
ingest_text_content |
Prepare text for the 3-call extraction workflow |
Utility (1 tool)
| Tool | Description |
|---|---|
fetch_url_content |
Scrape a URL and return clean text |
3-Call Ingestion Workflow
The recommended way to populate a knowledge graph from text:
ingest_text_content(project_code, text)→ Returns the graph schema + extraction instructions- LLM extracts all entities and relationships from the text (guided by the instructions)
add_knowledge_nodes+add_knowledge_relationships→ Bulk write everything
The AI does the thinking. Graforest stores the results.
Cloud Deployment (LogicBlok Module)
Graforest MCP deploys as a LogicBlok module through the RationalBloks platform. No kubectl, Docker CLI, or cluster access needed.
Deploy via RationalBloks UI
- Log in at infra.rationalbloks.com
- Select the Graforest project → Modules → Deploy Module
- Settings:
- Name:
graforest-mcp - Type:
logicblok - Repo:
https://github.com/graforest/graforest-mcp - Dockerfile:
Dockerfile(root of repo)
- Name:
- Set environment variables:
GRAFOREST_RB_API_KEY— Graforest service account key (rb_sk_...)RATIONALBLOKS_MCP_URL—https://logicblok.rationalbloks.comTRANSPORT—httpHOST—0.0.0.0
- Deploy. The platform handles: clone → build → push → K8s → TLS.
What the Platform Creates
| Resource | Value |
|---|---|
| Namespace | customer-{project_code}-staging |
| Domain | {module_code}-mod.customersblok.rationalbloks.com |
| Port | 8000 with /health probes |
| TLS | Auto-provisioned by cert-manager |
Dockerfile
The included Dockerfile m
Tools (13)
create_knowledge_projectProvision a new knowledge graph (Neo4j)list_knowledge_projectsList all graph projectsdelete_knowledge_projectDelete a graph project permanentlyadd_knowledge_nodesBulk create entities (max 500/batch)add_knowledge_relationshipsBulk create relationships (max 500/batch)search_knowledge_graphFull-text search across all node fieldsget_knowledge_schemaGet entity types, relationship types, and fieldsget_knowledge_statisticsNode and relationship counts by typetraverse_knowledge_graphWalk connections from any nodelist_knowledge_entitiesList entities by type (paginated)get_knowledge_entityGet a single entity by IDingest_text_contentPrepare text for the 3-call extraction workflowfetch_url_contentScrape a URL and return clean textEnvironment Variables
GRAFOREST_API_KEYrequiredAPI key for Graforest serviceConfiguration
claude_desktop_config.json
{"mcpServers": {"graforest": {"command": "uvx", "args": ["graforest-mcp"], "env": {"GRAFOREST_API_KEY": "gf_sk_your_key_here"}}}}Try it
→Create a knowledge graph about organic chemistry and populate it from my notes.
→Search the knowledge graph for all entities related to 'mitochondria'.
→List all knowledge projects currently available in my account.
→Traverse the knowledge graph starting from the entity with ID 'chem-001'.
→Ingest the content from this URL and extract the key entities into my graph.