mcpField
T
TypeDB

TypeDB

Local
typedb.comDatabases13Updated 1w ago
RepositoryVisit website

About TypeDB

TypeDB MCP Server lets AI assistants interact with TypeDB databases through natural language. It is for users who need to query data or manage databases and users, and supports TypeQL read, write, and schema queries alongside administration operations.

Key features

  1. 01Run TypeQL read, write, and schema queries
  2. 02List, create, and delete databases
  3. 03List, create, and delete users

Use cases

  1. 01Query TypeDB data in natural language
  2. 02Inspect or modify database schemas
  3. 03Create or delete TypeDB databases
  4. 04Manage TypeDB users

MCP support

The MCP server exposes TypeQL query execution and database and user management operations to clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "typedb-typedb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/typedb/typedb-mcp:1.0.2"
      ]
    }
  }
}
Run commanddocker run -i --rm docker.io/typedb/typedb-mcp:1.0.2

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocidocker.io/typedb/typedb-mcp:1.0.2

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

TypeDB MCP on mcprush

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

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

  1. Start the MCP server (see above)

  2. Open Cursor Settings → MCP

  3. Add the server configuration. Create or edit .cursor/mcp.json in your project:

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

  1. Restart Cursor or refresh MCP connections

  2. 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:

podman login docker.io

VERSION=<desired version number>
podman build -t typedb/typedb-mcp:$VERSION .
podman push typedb/typedb-mcp:$VERSION

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.