The io.github.typedb/typedb-mcp MCP server executes TypeQL queries and manages databases and users on a TypeDB server. Its purpose is to provide protocol-accessible operations for interacting with TypeDB, based on the server’s stated capability to run TypeQL and handle database and user administration.

🛠️ Key Features

Execute TypeQL queries
Manage databases on a TypeDB server
Manage users on a TypeDB server

🚀 Use Cases

Running TypeQL queries against TypeDB
Creating, updating, or otherwise managing databases
Performing user management tasks in TypeDB

⚡ Developer Benefits

Centralizes TypeQL execution and TypeDB database/user management
Supports developer workflows that interact with TypeDB through MCP

⚠️ Limitations

Available details only describe TypeQL execution and database/user management; no further capabilities are specified

TypeDB MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to interact with TypeDB databases. This allows LLMs to execute TypeQL queries, manage databases, and manage users through natural language.

Available on Docker Hub: https://hub.docker.com/repository/docker/typedb/typedb-mcp

Features

Query Execution: Run TypeQL read, write, and schema queries
Database Management: List, create, and delete databases
User Management: List, create, and delete users

Running the Server

bash

docker run -p 8001:8001 typedb/typedb-mcp:<version> \
  --typedb-address <address> \
  --typedb-username <username> \
  --typedb-password <password>

If you're running TypeDB server on localhost:

replace <address> with http://host.docker.internal:8000 instead of http://localhost:8000
on Linux, add --add-host=host.docker.internal:host-gateway

Using with Cursor IDE

Start the MCP server (see above)
Open Cursor Settings → MCP
Add the server configuration. Create or edit .cursor/mcp.json in your project:

json

{
  "mcpServers": {
    "typedb": {
      "url": "http://localhost:8001/mcp"
    }
  }
}

Restart Cursor or refresh MCP connections
Start chatting! You can now ask Cursor to:
- "List all databases"
- "Create a database called 'mydb'"
- "Define an entity 'person' with attribute 'name' in database 'mydb'"
- "Insert a person with name 'Alice'"
- "Query all persons in the database"

Building from Source

Use podman or Docker to create a Docker image and push it to DockerHub: