Data Commons MCP server.
Project description
Data Commons MCP Server
This is a Model Context Protocol (MCP) server for fetching public statistical data from Data Commons instances.
Data Commons is an open knowledge repository that provides a unified view across multiple public data sets and statistics. This server allows any MCP-enabled agent or client to query the Data Commons knowledge graph.
Features
- MCP-Compliant: Implements the Model Context Protocol for seamless agent integration.
- Data Commons Access: Fetches public statistics and data from the base datacommons.org knowledge graph.
- Custom Instance Support: Can be configured to work with Custom Data Commons instances.
- Flexible Serving: Runs over both streamable HTTP and stdio.
Quickstart
Prerequisites
- You must have a Data Commons API key; create one at apikeys.datacommons.org.
- Install
uvby following the official installation instructions.
Configuration
Set the following required environment variable in your shell:
export DC_API_KEY=<your API key>
Start the server
Run the server from your command line in one of two modes:
Streamable HTTP
This runs the server with Streamable HTTP.
# Runs on default port 8080
uvx datacommons-mcp serve http [--port <PORT>]
The server will be available at http://localhost:<port>/mcp.
stdio
This transport mode is intended for local integrations and is programmatically configured within a client (like Gemini CLI settings) to communicate over stdio.
uvx datacommons-mcp serve stdio
Clients
You can use any MCP-enabled agent or client to connect to your running server. For example, see the Data Commons MCP documentation for guides on connecting:
Or see your preferred client's documentation for how to configure it, using the commands listed above.
Advanced Configuration
Using MCP Tools with a Custom Data Commons
Follow the Guide for using MCP Tools with Custom Data Commons to set additional environment variables required for custom configuration.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file datacommons_mcp-1.2.1.tar.gz.
File metadata
- Download URL: datacommons_mcp-1.2.1.tar.gz
- Upload date:
- Size: 192.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e9f7c931861579b07ca257326e84019bbe58951163bc1582e19368f3fb670ef4
|
|
| MD5 |
1c30745f8d4d8ca160f8593e48a9e9d4
|
|
| BLAKE2b-256 |
3ead4dcf2053dfcd87f7a4a243cdacf0f25ce38db945becac89c25ea42c3b6ad
|
File details
Details for the file datacommons_mcp-1.2.1-py3-none-any.whl.
File metadata
- Download URL: datacommons_mcp-1.2.1-py3-none-any.whl
- Upload date:
- Size: 186.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb02b9d3c18c951032ab6fb145e222a0a969b36c711cb3b2ca93c69ac132300f
|
|
| MD5 |
fec2cd912dee7ef06071665f73736c17
|
|
| BLAKE2b-256 |
64d99f1b32d1a731457b848757becc2b486a59b09bff4d3c1f30e8553aca4193
|
