@datalanguage/datagraphs-mcp-server

An MCP (Model Context Protocol) server that exposes the Data Graphs knowledge graph platform to AI assistants such as Claude, ChatGPT, Cursor, and other MCP-compatible clients.

Prerequisites

• Node.js 18+

• A Data Graphs project with an API key

Related MCP server: Neo4j GraphRAG MCP Server

Installation

npm install @datalanguage/datagraphs-mcp-server

Or run directly with npx:

npx @datalanguage/datagraphs-mcp-server

Configuration

Obtaining Credentials

To generate the API key, client ID, and client secret:

1. Sign in to Data Graphs and open your project.

2. Click Manage Project.

3. Go to Applications and click Add Application.

4. Once the application is created, the API key, client ID, and client secret will be displayed.

Important: The client secret is shown only once at creation time. Copy it immediately and store it somewhere secure — if lost, you will need to rotate the credentials or create a new application to obtain a new secret.

Your project ID can also be found on the project page in Data Graphs.

Environment Variables

The server reads credentials from environment variables:

MCP Client Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "datagraphs": {
      "command": "npx",
      "args": ["-y", "@datalanguage/datagraphs-mcp-server"],
      "env": {
        "DATAGRAPHS_PROJECT_ID": "your-project-id",
        "DATAGRAPHS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add datagraphs -- npx -y @datalanguage/datagraphs-mcp-server

Then set the required environment variables in your shell before launching Claude Code.

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "datagraphs": {
      "command": "npx",
      "args": ["-y", "@datalanguage/datagraphs-mcp-server"],
      "env": {
        "DATAGRAPHS_PROJECT_ID": "your-project-id",
        "DATAGRAPHS_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

The server provides the following tools:

list_datasets

List all datasets available in the Data Graphs project.

search_concepts

Search for concepts (nodes) across datasets using text queries, filters, and facets.

get_concept

Get a single concept (node) by its URN identifier.

graph_search

Execute a GQL graph query against the knowledge graph. Requires DATAGRAPHS_CLIENT_ID and DATAGRAPHS_CLIENT_SECRET.

search_transactions

Search the transaction/audit log for the project.

get_model

Get the currently active data model for the project. Takes no parameters.

Development

git clone <repo-url>
cd datagraphs-client-mcp-server
npm install
npm start

License

UNLICENSED