English Français العربية

io.github.p-meier/northdata-mcp

السجل الرسمي أخرى

NorthData API for German company, owner, and financial data — with a built-in credit guard.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package northdata-mcp
Claude Code 
claude mcp add northdata-mcp -e 'NORTHDATA_API_KEY=<your northdata_api_key>' -e 'NORTHDATA_APPROVAL_THRESHOLD=<NORTHDATA_APPROVAL_THRESHOLD>' -e 'NORTHDATA_ABSOLUTE_MAX=<NORTHDATA_ABSOLUTE_MAX>' -e 'NORTHDATA_CREDIT_LOG=<NORTHDATA_CREDIT_LOG>' -- uvx northdata-mcp==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "northdata-mcp": {
            "command": "uvx",
            "args": [
                "northdata-mcp==0.1.1"
            ],
            "env": {
                "NORTHDATA_API_KEY": "<your northdata_api_key>",
                "NORTHDATA_APPROVAL_THRESHOLD": "<NORTHDATA_APPROVAL_THRESHOLD>",
                "NORTHDATA_ABSOLUTE_MAX": "<NORTHDATA_ABSOLUTE_MAX>",
                "NORTHDATA_CREDIT_LOG": "<NORTHDATA_CREDIT_LOG>"
            }
        }
    }
}

متغيرات البيئة

  • NORTHDATA_API_KEY إلزامي سري Your NorthData API key. Obtain one at https://www.northdata.com
  • NORTHDATA_APPROVAL_THRESHOLD Power-search 'limit' above this requires approve_high_cost=true. Default: 25.
  • NORTHDATA_ABSOLUTE_MAX Hard ceiling for power-search 'limit'. Default: 100. Flag-immune.
  • NORTHDATA_CREDIT_LOG Path to the local credit log file. Default: ~/.northdata/credits.jsonl

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. NorthData Connectors
  2. Why this exists
  3. Quick start
  4. Architecture
  5. Development
  6. License
  7. Links

NorthData Connectors

Generic, product-side wrapper around the NorthData API — a Python CLI, an MCP server, and a Claude Skill, sharing one credit guard.

Unofficial project. This repository is an independent, community-maintained wrapper around the NorthData API. It is not developed, endorsed, or supported by NorthData GmbH. "NorthData" is a trademark of its respective owner; all company data accessed through this tooling remains subject to NorthData's own terms of service. For the official API documentation, see github.com/northdata/api.

This monorepo ships three layers on top of the NorthData API:

PackageWhat it isInstall
northdata-cliCommand-line client. JSON-by-default, table with --pretty. Single source of API logic.pipx install northdata-cli
northdata-mcpModel Context Protocol server exposing every CLI command as a tool. Works with Claude Desktop, Claude Code, Cursor, etc.pipx install northdata-mcp
skills/northdataClaude Skill with usage guidance, credit-guard discipline, and endpoint cheat-sheet.npx skills add p-meier/northdata-connectors

All three share one credit guard because NorthData charges per returned company, not per HTTP call.

Why this exists

NorthData's API is the canonical source for German commercial-register data (company profiles, owners, representatives, financials, publications). This repo makes it trivial to consume that data from:

  • Shell scripts and CI pipelines (northdata search ...)
  • AI agents in any MCP-capable client (Claude Desktop, Cursor, Claude Code, …)
  • Claude Skills that want domain-aware guidance without duplicating API code

The three layers never duplicate logic — the CLI is the library, the MCP server imports it, the Skill references the MCP tools.

Quick start

1. Get a NorthData API key

At https://www.northdata.com. Set it as NORTHDATA_API_KEY.

2. Install what you need
# Shell usage
pipx install northdata-cli
export NORTHDATA_API_KEY=XXXX-XXXX
northdata suggest "Siemens" --pretty

# MCP server for Claude Desktop / Cursor / Claude Code
pipx install northdata-mcp
# then add the stdio server to your MCP client config
# (see northdata-mcp/README.md)

# Claude Skill — usage guidance for agents
npx skills add p-meier/northdata-connectors
3. Credit-safe by default

Every billable call respects two tiers:

TierDefaultEnv var
Approval threshold25NORTHDATA_APPROVAL_THRESHOLD
Absolute maximum100NORTHDATA_ABSOLUTE_MAX

Use --dry-run (CLI) or dry_run=true (MCP) to inspect a request without spending credits.

Architecture

                      ┌─────────────────────────────────────────┐
                      │         NorthData API (HTTP)            │
                      └─────────────────────────────────────────┘
                                        ▲
                                        │ httpx + Credit Guard
                                        │
                            ┌───────────────────────┐
                            │   northdata-cli       │  ← single source of API logic
                            │   (Python library)    │     (client, credit guard,
                            └───────────────────────┘      config, output)
                                ▲               ▲
                    imports     │               │  invokes
                                │               │
              ┌───────────────────────┐   ┌───────────────────────┐
              │   northdata-mcp       │   │   shell / CI /        │
              │   (FastMCP, stdio)    │   │   scripts             │
              └───────────────────────┘   └───────────────────────┘
                        ▲
                        │ MCP over stdio
                        │
              ┌───────────────────────┐
              │   Claude / Cursor /   │   ← with skills/northdata/SKILL.md
              │   any MCP client      │     loaded for usage guidance
              └───────────────────────┘

The CLI holds the API logic; the MCP server is a thin wrapper; the Skill is documentation-as-code. All three share one credit guard.

Development

git clone https://github.com/p-meier/northdata-connectors.git
cd northdata-connectors

# CLI
cd northdata-cli && python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]" && pytest

# MCP
cd ../northdata-mcp && python -m venv .venv && source .venv/bin/activate
pip install -e "../northdata-cli" -e ".[dev]" && pytest

License

MIT. See LICENSE.

الأسئلة الشائعة

ما هو io.github.p-meier/northdata-mcp؟

NorthData API for German company, owner, and financial data — with a built-in credit guard.

كيف أثبّت io.github.p-meier/northdata-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add northdata-mcp -e 'NORTHDATA_API_KEY=<your northdata_api_key>' -e 'NORTHDATA_APPROVAL_THRESHOLD=<NORTHDATA_APPROVAL_THRESHOLD>' -e 'NORTHDATA_ABSOLUTE_MAX=<NORTHDATA_ABSOLUTE_MAX>' -e 'NORTHDATA_CREDIT_LOG=<NORTHDATA_CREDIT_LOG>' -- uvx northdata-mcp==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.p-meier/northdata-mcp إلى مفتاح API؟

نعم. يتطلب NORTHDATA_API_KEY، وتضبطها في إعداداته.

هل io.github.p-meier/northdata-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.p-meier/northdata-mcp؟

ينشره p-meier. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.