agemcp by veloper - MCP Server

Apache AGE MCP Server

These tools provide an interface for AI Agents to manage multiple graphs in Apache AGE. They expose tools for creating, updating, administering, and visualizing graphs.

Tool Name	Description	Parameters
`get_or_create_graph`	Get or create a graph with the specified name.	`graph_name: str`
`list_graphs`	List all graph names in the database.
`upsert_graph`	Upsert both vertices and edges into the specified graph (deep merge).	`graph_name: str`, `vertices: List[Dict[str, Any]]`, `edges: List[Dict[str, Any]]`
`upsert_edge`	Insert or update an edge's properties in a graph non-destructively.	`graph_name: str`, `label: str`, `edge_start_ident: str`, `edge_end_ident: str`, `properties: Dict[str, Any]`
`upsert_vertex`	Insert or update a vertex's properties in a graph non-destructively.	`graph_name: str`, `vertex_ident: str`, `label: str`, `properties: Dict[str, Any]`
`drop_graphs`	Drop one or more graphs by name.	`graph_names: List[str]`
`drop_vertex`	Remove a vertex by ident.	`graph_name: str`, `vertex_ident: str`
`drop_edge`	Remove an edge by ident.	`graph_name: str`, `edge_ident: str`
`generate_visualization`	Generate a single-page HTML file visualizing a graph using vis.js and pyvis.	`graph_name: str`

Server Installation

Install the latest release using pipx (recommended for CLI/server tools):


# Install
pipx install agemcp

# Postgres DSN / MCP Server Defaults
agemcp config

# Start the server
agemcp run

You should see something like this:

INFO:     Starting MCP server 'agemcp' with transport 'streamable-http' on http://0.0.0.0:8000/mcp/
INFO:     Started server process [13951]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

Client Installation

VSCode

Open Command Palette (Cmd+Shift+P or Ctrl+Shift+P).
Select MCP: Add Server...
Choose "HTTP" option.
Enter the server URL (e.g., http://localhost:8000/mcp/).
Enter a "server id" (e.g., agemcp).
Select Global for the scope.
Done. (It should appear in the extensions sidebar.)

Roo / Cline / Claude

{
  "mcpServers": {
    "agemcp": {
      "url": "http://localhost:8000/mcp/",
      "type": "streamable-http",
      "headers": {
        "Content-Type": "application/json"
      }
    }
  }
}