TypeDB
Execute TypeQL queries and manage databases and users on a TypeDB server.
Open source Open in the app JSON README (API)
About
Execute TypeQL queries and manage databases and users on a TypeDB server.
Details
- Kind
- MCP servers
- Topic
- Databases
- Publisher
- typedb
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Stars
- 13
- Forks
- 10
- Last push
- 2026-07-17T15:37:46Z
- Repository state
- ativo
- Language
- Python
- License
- NOASSERTION
- Added
- 2026-08-29 04:01:36
- Updated
- 2026-08-29 04:01:36
- Origin id
io.github.typedb/typedb-mcp
README
# TypeDB MCP Server
An MCP (Model Context Protocol) server that enables AI assistants to interact with [TypeDB](https://typedb.com) 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
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:
```json
{
"mcpServers": {
"typedb": {
"url": "http://localhost:8001/mcp"
}
}
}
```
4. Restart Cursor or refresh MCP connections
5. 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:
```bash
podman login docker.io
VERSION=<desired version number>
podman build -t typedb/typedb-mcp:$VERSION .
podman push typedb/typedb-mcp:$VERSION
```