# Binggio

The Binggio MCP server for Claude Code answers data questions using meanings and relationships approved by a person. When it cannot form a precise answer, it refuses and gives a reason.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: binggio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/binggio/binggio
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/binggio

## What it does

Binggio maps questions to approved column roles, business terms and table relationships. The agent forms a plan from that vocabulary; the server validates it, then returns an answer with its sources and filters or declines the request. It does not accept SQL.

The server runs on the local machine with files and databases, and does not write to source data. Set `BINGGIO_WORKSPACE` to the workspace path; the MCP command starts it with `uvx binggio`. Natural-language questions need `BINGGIO_LLM_API_KEY` or `OPENAI_API_KEY`.

A person approves meanings and links in the app. Decisions and refusal reasons are recorded, and approvals stop applying after the underlying data changes. Profiling, relationship discovery, review and saved-plan runs work without a model key.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `BINGGIO_WORKSPACE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add binggio -e BINGGIO_WORKSPACE=<BINGGIO_WORKSPACE> -- uvx binggio
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from binggio <command>

### Codex

**Platform CLI**
```bash
codex mcp add binggio --env BINGGIO_WORKSPACE=<BINGGIO_WORKSPACE> -- uvx binggio
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from binggio <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "binggio": {
            "command": "uvx",
            "args": [
                "binggio"
            ],
            "env": {
                "BINGGIO_WORKSPACE": "<BINGGIO_WORKSPACE>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from binggio <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "binggio": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "binggio"
            ],
            "env": {
                "BINGGIO_WORKSPACE": "<BINGGIO_WORKSPACE>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from binggio <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BINGGIO_WORKSPACE=<BINGGIO_WORKSPACE> binggio uvx binggio
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from binggio <command>

## When to use it
- answer questions about tables using approved definitions
- trace the links between two tables
- inspect the sources and filters behind an answer
- record why a question was refused

## Example prompts
- Answer what this overdue-status value means using approved definitions only.
- Show the relationship path between the customer and payment tables.
- Find the approved meaning for this code and show the sources used.

## Similar
- [IterableData](https://affpapa.org/en/nevibecode/mcp/iterabledata.md) — MCP server · ★ 38 repo stars
- [douban-skill](https://affpapa.org/en/nevibecode/skills/douban-skill.md) — skill · 815 installs
- [read-file](https://affpapa.org/en/nevibecode/skills/read-file.md) — skill · 1400 installs
- [claude-ecom](https://affpapa.org/en/nevibecode/plugins/claude-ecom.md) — plugin · ★ 1013 repo stars
- [mcp-sqlite-tools](https://affpapa.org/en/nevibecode/mcp/mcp-sqlite-tools.md) — MCP server · ★ 20 repo stars
- [codex-usage-tracker](https://affpapa.org/en/nevibecode/plugins/codex-usage-tracker.md) — plugin · ★ 1596 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
