Metaverse
AI-powered interface for Metabase — query your data, build dashboards, and set up alerts using natural language.
Skills
Use these Claude Code slash commands from any project connected to Metaverse:
| Skill | Description | Example |
|---|---|---|
/metaask |
Ask a data question, get a table back | "How many customers do we have in the US?" |
/metaquery |
Build and save a custom query | "Show me the latest orders by customer #100" |
/metaboard |
Build a dashboard from a description | "Monthly overview of Gift Card sales" |
/metametric |
Create or explore a reusable named metric | "Create a Total Revenue metric on orders" |
/metalert |
Set up a metric alert | "Notify me when any provider has more than 10 refunds in an hour" |
What it solves
- Extracting data from databases without writing SQL manually
- Building dashboards and alerts without navigating the Metabase UI
- Exploring data structures and relationships through conversation
- Spotting patterns and anomalies by just asking
Integrations
Works wherever Claude agents run:
- Claude Code — local CLI (primary target)
- Claude Desktop — local app via ngrok tunnel
- Claude in Slack — team-wide data questions (planned)
- Claude in GitHub — data questions in issues and PRs (planned)
How it works
An MCP server exposes Metabase as a set of tools Claude can call — browsing databases and tables, running SQL queries, creating saved questions, assembling dashboards, and managing alerts. Claude handles the natural language layer; Metabase handles the data layer.
Stack
- Python + FastMCP — MCP server (HTTP transport)
- Metabase OSS + Postgres — data layer, both run locally via Docker
- Justfile — task runner for starting services, seeding data, and config
Agent integration
Claude Code
Add to .mcp.json in your project root:
{
"mcpServers": {
"metaverse": {
"type": "http",
"url": "http://localhost:8000/mcp"
}
}
}
Run just up to start the stack, then open Claude Code. The slash commands (/metaask, /metaquery, /metaboard, /metalert) and all MCP tools are available immediately.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"metaverse": {
"command": "uvx",
"args": ["--from", "metaverse-mcp", "metaverse"],
"env": {
"METABASE_URL": "https://your-metabase.example.com",
"METABASE_API_KEY": "mb_xxxx"
}
}
}
}
Restart Claude Desktop. The metaask, metaquery, metaboard, and metalert prompts appear in the UI — no slash commands needed.
Local Metabase only? Claude Desktop requires HTTPS even for localhost. Run
ngrok http 3000and use the tunnel URL asMETABASE_URL.
Any MCP-compatible agent
Point the agent at the running HTTP server:
http://localhost:8000/mcp
The server exposes 14 tools and 3 schema resources (metaverse://schema, metaverse://database/{id}, metaverse://table/{id}) that any MCP client can discover and use.
Getting started
See HOWTO.md for full setup instructions.
just up # start Postgres + Metabase + MCP server
just setup # first-run: create admin account + API key
claude # open Claude Code — skills and MCP tools are ready
Metadata
Release files for metaverse-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| metaverse_mcp-0.1.2.tar.gz | 93.3 kB | Without provenance | Details for metaverse_mcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| metaverse_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for metaverse_mcp-0.1.2-py3-none-any.whl |
Total release size: 113.6 kB
Release files / metaverse_mcp-0.1.2.tar.gz
| Download URL | metaverse_mcp-0.1.2.tar.gz |
|---|---|
| Size | 93.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c5fe82c420434e016057d3c67680965af1c2331dc69c73a8d78cd5ecf619558
|
|
BLAKE2b-256 checksum How to use checksums |
c8901e157293043b2092027b22fb3af799f720e272335a6ead3050ffaf75f322
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / metaverse_mcp-0.1.2-py3-none-any.whl
| Download URL | metaverse_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 20.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b5eb9964e9a4f490d58671dc3552b2ee7b40625ea2b9b7aaae338ccd9a369b08
|
|
BLAKE2b-256 checksum How to use checksums |
c8fe23489ee4bffdbd3176beebcb788563ebf326568a512e0e8e1cde02ecef58
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for metaverse-mcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.