Deploy Graphiti 0.31 MCP + FalkorDB

Deploy and Host Graphiti 0.31 MCP + FalkorDB on Railway

Graphiti is Zep's open-source temporal knowledge graph for AI agent memory. Agents send it what they learn, an LLM extracts entities and facts, and Graphiti stores them with the time each fact was valid. Claude, Cursor or any MCP client can then search that memory. This template runs the official Graphiti MCP server with FalkorDB inside one container, behind a bearer-token proxy.

About Hosting Graphiti 0.31 MCP + FalkorDB

Upstream's MCP server has no authentication: Zep calls it a reference implementation and warns not to expose it to an untrusted network. Here the Graphiti service (zepai/knowledge-graph-mcp:1.1.3-graphiti-0.31.2, which bundles the FalkorDB graph database) is private. The only public service is a small Caddy proxy that requires Authorization: Bearer on every request. The token is generated at deploy. Responses stream through without buffering (MCP streamable HTTP). The template replaces the image's start script so that FalkorDB listens on localhost only, writes an append-only file to the volume (so a redeploy loses at most about a second of writes), and doesn't start the unauthenticated FalkorDB Browser. Two services, about 0.3 GB of RAM at idle. You only enter your OpenAI (or OpenAI-compatible) API key.

Common Use Cases

• Long-term memory for Claude Code, Claude Desktop, Cursor or VS Code: preferences, project decisions and procedures that persist across sessions
• Shared memory for a team of agents, with one group_id per user or project
• A low-cost temporal knowledge graph for agent frameworks (LangGraph, CrewAI, custom agents)

Dependencies for Graphiti 0.31 MCP + FalkorDB Hosting

• Graphiti MCP server 1.1.3 with graphiti-core 0.31.2 and FalkorDB (zepai/knowledge-graph-mcp:1.1.3-graphiti-0.31.2), private, volume
• Token Proxy (caddy:2.11.9-alpine), public, bearer token required
• An API key for OpenAI or an OpenAI-compatible provider whose models support structured output

Deployment Dependencies

• Graphiti on GitHub: https://github.com/getzep/graphiti
• MCP server documentation: https://github.com/getzep/graphiti/tree/v0.31.2/mcp_server
• FalkorDB: https://github.com/FalkorDB/FalkorDB

Implementation Details

After deploy, open the Token Proxy service's Variables tab and copy MCP_URL and PROXY_TOKEN.

Claude Code:

claude mcp add --transport http graphiti https:///mcp \
  --header "Authorization: Bearer "

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "graphiti": {
      "url": "https:///mcp",
      "headers": { "Authorization": "Bearer " }
    }
  }
}

Claude Desktop's custom connector dialog has no field for custom headers, so use the mcp-remote bridge in claude_desktop_config.json:

{
  "mcpServers": {
    "graphiti": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https:///mcp", "--header", "Authorization:${GRAPHITI_AUTH}"],
      "env": { "GRAPHITI_AUTH": "Bearer " }
    }
  }
}

Requests without the token get 401. The tools are add_memory, search_nodes, search_memory_facts, get_episodes, delete_episode, add_triplet, build_communities, clear_graph and more. add_memory returns at once and extracts in the background.

The token gives full access to every group, so share it only with clients you trust. Text stored as memory comes back to your agent later, so don't store memories from untrusted sources (upstream has no prompt-injection protection). FalkorDB is licensed under SSPL v1. For Neo4j Browser, Cypher and a database you can reach from your own tools, use the Graphiti 0.31 MCP + Neo4j template.

Why Deploy Graphiti 0.31 MCP + FalkorDB on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Graphiti 0.31 MCP + FalkorDB on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.