From e5b63773351c595fe7624a52870417049ea70fb5 Mon Sep 17 00:00:00 2001 From: Chandan <113630375+mrfandu1@users.noreply.github.com> Date: Mon, 14 Sep 2026 22:11:30 +0545 Subject: [PATCH 1/2] Add German, Simplified Chinese and Japanese README translations --- README.de.md | 294 ++++++++++++++++++++++++++++++++++++++++++++++++ README.ja.md | 294 ++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 4 + README.zh-CN.md | 294 ++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 886 insertions(+) create mode 100644 README.de.md create mode 100644 README.ja.md create mode 100644 README.zh-CN.md diff --git a/README.de.md b/README.de.md new file mode 100644 index 00000000..13dec9d6 --- /dev/null +++ b/README.de.md @@ -0,0 +1,294 @@ +

+ AnythingMCP — 188 Connectors, 26 davon ohne API-Schlüssel. Deine REST-, SOAP/WSDL-, GraphQL-, SQL- und MCP-Systeme werden zu Tools für Claude, ChatGPT, Copilot und Gemini. +

+ +

AnythingMCP

+ +

+ English · Deutsch · 简体中文 · 日本語 +

+ +

+ Gib Claude, ChatGPT und Copilot sicheren Zugriff auf die Software, die dein Unternehmen bereits nutzt.
+ 188 fertige Adapter, beliebige REST-/SOAP-/GraphQL-/SQL-Systeme ohne eigenen Code, auf deiner eigenen Infrastruktur — und ein System, das lernt, wie deine Anwendungen zusammenhängen. +

+ +

+ GitHub Stars + Release + Open source, AGPL-3.0 + Docker pulls +

+ +**Claude beantwortet eine Frage, die zuvor kein Chatbot beantworten konnte**, weil die Daten in einem Außendienstsystem liegen, das REST statt MCP spricht: + +

+ Claude beantwortet die Frage, welche Firmen ein Techniker letzte Woche besucht hat, und ruft dafür von AnythingMCP bereitgestellte Tools an einem laufenden Außendienstsystem auf. +

+ +**Selbst ausprobieren** — drei Zeilen, ohne das Repository zu klonen, [Details weiter unten](#run-it-yourself): + +```bash +mkdir anythingmcp && cd anythingmcp +curl -fsSLo docker-compose.yml \ + https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml +printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env +docker compose up -d # → http://localhost:3000 +``` + +--- + +Drei Begriffe tauchen immer wieder auf und bezeichnen unterschiedliche Dinge: + +- Ein **Adapter** ist eine der 188 JSON-Definitionen in diesem Repository — DATEV, weclapp, DHL, Deutsche Bahn, Shopware, Personio, Handelsregister und viele weitere. 26 davon benötigen überhaupt keinen API-Schlüssel; bei den anderen gibst du deine Zugangsdaten beim Import an. +- Ein **Connector** entsteht, wenn du einen Adapter oder deine eigene OpenAPI-Spezifikation, Postman-Collection, WSDL, einen GraphQL-Endpunkt oder eine Datenbank in deinem Workspace konfigurierst. In wenigen Minuten lässt sich so eine Verbindung einrichten, ohne einen MCP-Server zu programmieren. +- Ein **MCP-Server** ist die URL, die du Claude übergibst. Er stellt ausschließlich die Connectors bereit, die du ihm zuweist. + +Alles läuft auf deiner Infrastruktur. Du entscheidest also, welche Daten sie verlassen. Das Response-Mapping legt für jedes Tool fest, welche Felder das Modell erreichen dürfen. Gespeicherte Zugangsdaten werden mit AES-256-GCM verschlüsselt; das Audit-Log bewahrt die vollständige Antwort des angebundenen Systems bei dir auf. OAuth2, RBAC, SSO und SCIM sind im selbst gehosteten Build enthalten und werden nicht einem kostenpflichtigen Tarif vorbehalten. + +**Im produktiven Einsatz bei [KOCH Freiburg GmbH](https://www.kochfreiburg.de/)**: Dort verbindet AnythingMCP KI-Assistenten mit mehr als 15 internen Systemen — ERP, CRM, SOAP-Diensten und lokalen Datenbanken. [helpcode.ai](https://helpcode.ai) aus Freiburg hat AnythingMCP aus diesem System herausgelöst und als Open Source veröffentlicht, weil ein Adapterkatalog in einer Community schneller wächst als als einzelnes Produkt. + +--- + + + +## Selbst betreiben + +**Der empfohlene Weg**, auf dem auch die unten genannten Messungen beruhen. Benötigt werden Docker 24+ und `openssl`; starte unter macOS zuerst Docker Desktop. + +```bash +mkdir anythingmcp && cd anythingmcp +curl -fsSLo docker-compose.yml \ + https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml +printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env +docker compose up -d +``` + +Öffne und registriere dich — **das erste Konto erhält Administratorrechte**. + +> **Bewahre die erzeugte `.env` auf.** Mit `ENCRYPTION_KEY` werden die gespeicherten Zugangsdaten entschlüsselt. Geht dieser Schlüssel verloren, musst du die Zugangsdaten für jeden Connector neu hinterlegen. Sichere ihn dort, wo du auch deine anderen Geheimnisse aufbewahrst. + +| Dienst | Standard-URL | +|---|---| +| Weboberfläche | `http://localhost:3000` | +| MCP-Endpunkt | `http://localhost:4000/mcp` | +| Swagger-Dokumentation | `http://localhost:4000/api/docs` | + +*Auf amd64 gemessen: 31 s für den Image-Download, 24 s bis zu einer betriebsbereiten API und einer Anmeldeseite. Das veröffentlichte Image unterstützt vorerst nur amd64. Die Compose-Datei legt die Plattform deshalb ausdrücklich fest, sodass es auf Apple Silicon unter der Emulation von Docker Desktop läuft. Derselbe Start dauerte auf einem Laptop mit M-Chip 24 s; auf älterer Hardware kann er einige Minuten beanspruchen.* + +Der Schnellstart bindet die Dienste bewusst an `127.0.0.1`: Es gibt davor noch keine TLS-Terminierung. **Für eine Instanz, die andere Personen oder ein KI-Client aus der Cloud erreichen können sollen**, klone das Repository und führe `./setup.sh` aus. Das Skript fragt nach einer Domain, beschafft Zertifikate über Caddy, erzeugt die Geheimnisse und legt den MCP-Authentifizierungsmodus fest. Siehe die [Deployment-Anleitung](docs/deployment.md). + +
+Weitere Deployment-Möglichkeiten — verwaltete Cloud, Railway, DigitalOcean + +
+ +[**AnythingMCP Cloud**](https://cloud.anythingmcp.com) verwendet denselben AGPL-Code und wird von uns in **Frankfurt, Deutschland** betrieben. Damit kannst du es mit deinen eigenen APIs ausprobieren, ohne selbst Infrastruktur bereitzustellen. Wenn die Zugangsdaten dein Unternehmen nicht mehr verlassen sollen, ziehst du die Installation zu dir um — die Connectors bleiben dieselben. Eine DPA/AVV ist auf Anfrage über [info@helpcode.ai](mailto:info@helpcode.ai) erhältlich. SSO und SCIM stehen nur beim Self-Hosting zur Verfügung. + +[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/8-X4WD?referralCode=k30bPV&utm_medium=integration&utm_source=template&utm_campaign=generic) +  +[![Install on DigitalOcean](https://www.deploytodo.com/do-btn-blue.svg)](https://marketplace.digitalocean.com/apps/anythingmcp) + +
+ +--- + +## Was AnythingMCP verbindet, steuert und lernt + +### Verbinden + +- **5 Connector-Typen** — [REST](docs/connectors/rest.md), [SOAP](docs/connectors/soap.md), [GraphQL](docs/connectors/graphql.md), [Datenbank](docs/connectors/database.md), [MCP-zu-MCP-Brücke](docs/connectors/mcp-bridge.md). Sieben Datenbank-Engines: PostgreSQL, MySQL, MariaDB, MSSQL, Oracle, MongoDB, SQLite. +- **Vorhandenes importieren** — OpenAPI/Swagger, Postman, cURL, WSDL, GraphQL-Introspection oder die Tool-Erkennung direkt an einem laufenden MCP-Server. +- **Der Adapterkatalog** — [was bereits enthalten ist](#the-adapter-catalog). +- **Visueller Tool-Editor** — ordne Parameter dem Pfad, Query-Parametern, Request-Body und Headern zu. Benenne und beschreibe Tools so, dass die KI sie wie beabsichtigt versteht. +- **Dynamischer MCP-Server** — Tools werden zur Laufzeit registriert, ohne Neustart. `{{VAR}}`-Interpolation pro Connector, für die KI verborgen. + +### Steuern + +- **[Antworten gezielt formen](#control-what-the-model-sees)** — lege für jedes Tool genau fest, welche Felder das Modell erreichen, mit einer direkten Vorher-Nachher-Vorschau. +- **Nur lesen, wo es darauf ankommt.** Jedes Tool trägt MCP-Annotationen (`readOnlyHint`, `destructiveHint`), die aus der Operation abgeleitet und pro Tool überschrieben werden können. So kann ein Client unterscheiden, ob eine Rechnung gelesen oder eine Gutschrift erstellt wird. Rollenbasierte Tool-Freigaben ermöglichen einen MCP-Server, der ausschließlich lesen darf — für die meisten ERP-Anbindungen der richtige Einstieg. +- **Alle gängigen Authentifizierungsverfahren** — OAuth2 (PKCE und Client Credentials), Bearer, API Key, Basic, WS-Security, Client-Zertifikate, [LOGIN_TOKEN](docs/connectors/login-token-auth.md) und OAuth 1.0a. +- **Audit-Logging** — jeder Tool-Aufruf wird mit Eingabe, Ausgabe, Dauer und Status in deiner eigenen Datenbank protokolliert. +- **[SSO](docs/sso.md) und [SCIM](docs/scim-entra-setup.md)** — Entra ID, Google, Okta, Auth0 und generisches OIDC. Rollen werden bei jeder Anmeldung mit den Gruppen deines Verzeichnisdienstes synchronisiert. Deaktivierst du dort eine Person, verlieren auch ihr Workspace-Zugriff und ihre MCP-API-Schlüssel ihre Gültigkeit (nur beim Self-Hosting). + +### Lernen + +- **[Knowledge Graph](docs/knowledge-graph.md)** — eine PII-sichere Übersicht pro Workspace darüber, wie die Daten deiner Connectors zusammenhängen. Sie wird dem Agenten als MCP-Tool bereitgestellt, damit er Aufrufe über mehrere Systeme hinweg richtig verknüpft. +- **[KI-Skills](docs/knowledge-graph.md)** — wiederkehrende Nutzungsmuster werden zu kleinen, wiederverwendbaren Regeln, die in die Anweisungen des Servers einfließen. Sie leiten den Agenten an, ohne einen zusätzlichen Tool-Aufruf zu benötigen (optional, muss aktiviert werden). + +--- + +## AnythingMCP im Vergleich + +Die Projekte, mit denen AnythingMCP häufig verglichen wird, sind überwiegend MCP-Gateways: Sie bündeln vorhandene MCP-Server, begrenzen deren Zugriff und sichern sie ab. AnythingMCP setzt einen Schritt früher an, denn die meisten Unternehmen haben noch gar keine MCP-Server — sondern eine REST-API, einen SOAP-Dienst aus dem Jahr 2009 und eine Datenbank, die niemand direkt zugänglich machen möchte. Jedes der folgenden Projekte löst ein echtes Problem, nur eben nicht dasselbe. + +| | Was es ist | Wähle es stattdessen, wenn … | +|---|---|---| +| **[ContextForge](https://github.com/IBM/mcp-context-forge)** (IBM) | Föderation und Registry vor bereits vorhandenen MCP-Servern | Deine Tools bereits MCP-Server sind und du Föderation, virtuelle Server und eine Registry brauchst | +| **[Docker MCP Gateway](https://github.com/docker/mcp-gateway)** | Führt MCP-Server aus einem Katalog als Container hinter einem Endpunkt aus, einschließlich Verwaltung von Geheimnissen | Du von Anbietern veröffentlichte MCP-Server in Docker isolieren möchtest und der vorhandene Katalog deinen Bedarf abdeckt | +| **[MetaMCP](https://github.com/metatool-ai/metamcp)** | Bündelt MCP-Server in Endpunkten mit getrennten Namensräumen und einer Middleware-Schicht | Du hauptsächlich vorhandene MCP-Server pro Client gruppieren und deren Zugriffsbereich neu festlegen möchtest | +| **[Composio](https://github.com/ComposioHQ/composio)** | Ein gehosteter Katalog verwalteter Integrationen, bei dem die Authentifizierung für dich übernommen wird | Dir ein fester verwalteter Katalog genügt und du keinen eigenen SOAP-Dienst, keine interne API und keine eigene Datenbank anbinden musst | +| **AnythingMCP** | Macht die bereits eingesetzten APIs, SOAP-Dienste und Datenbanken zu MCP-Tools | Deine Systeme **noch keine** MCP-Server sind und du selbst entscheiden möchtest, ob die Zugangsdaten bei dir bleiben | + +Vergleichsseiten mit vollständigen Funktionstabellen: [anythingmcp.com/vs](https://anythingmcp.com/vs). + +--- + + + +## Knowledge Graph & KI-Skills + +Das reine Weiterleiten von Aufrufen überlässt dem Agenten den schwierigen Teil: Welches Tool kommt als Nächstes, und was bedeutet in deinem Unternehmen eigentlich „offener Auftrag“ oder „aktiver Kunde“? AnythingMCP lernt beides — **wie die Daten deiner Connectors zusammenhängen** und **wie dein Team die Tools tatsächlich nutzt** — und gibt dieses Wissen als Kontext an den KI-Client zurück, statt zusätzliche Tool-Aufrufe zu erfordern. + +- **Knowledge Graph** — eine Übersicht pro Workspace über *Entitäten* (Kunden, Aufträge, Produkte …) und ihre *Beziehungen*. Sie entsteht aus Tool-Namen, Parametern sowie den Ein- und Ausgaben tatsächlicher Aufrufe. Ein optionaler KI-Durchlauf erschließt Verbindungen zwischen Connectors, die Heuristiken übersehen. Der Graph bleibt **PII-sicher**: Er speichert Entitäts- und Feld*namen* sowie Beziehungsmetadaten, niemals die Werte. +- **Visuell aufbauen** — mit einem Graph-Editor kannst du Entitäten und Verbindungen selbst anlegen, bearbeiten und löschen, Beschreibungen ergänzen und KI-Vorschläge prüfen. +- **Über MCP bereitstellen** — jeder Server stellt ein `kg_how_to_obtain`-Tool bereit. Damit kann der Agent *des Kunden* beispielsweise fragen: „Wie komme ich von einer Shopware-Bestellung zu einer DHL-Sendungsnummer?“ und erhält Hinweise zur Verknüpfung der Connectors. +- **KI-Skills aus der tatsächlichen Nutzung** — bei aktivierter Absichtserfassung kann jeder Tool-Aufruf festhalten, *warum* er erfolgte. Ein KI-Durchlauf macht aus wiederkehrenden Mustern kleine, wiederverwendbare Regeln (etwa: *„Der heutige Umsatz umfasst Aufträge mit den Statuswerten 2, 3 und 4“*). Du kannst jede Regel übernehmen, bearbeiten oder verwerfen, oder Vorschläge mit hoher Konfidenz automatisch übernehmen lassen. Übernommene Skills werden beim Bereitstellen in die **Anweisungen** des MCP-Servers eingefügt und leiten den Agenten an, **ohne einen einzigen zusätzlichen Tool-Aufruf**. Das Wissen, das dein Team durch die Nutzung aufbaut, bleibt nicht mehr nur in den Köpfen einzelner Personen. + +Die KI-Durchläufe sind **standardmäßig ausgeschaltet**. Du aktivierst sie über ein globales Umgebungsflag *und* einen Schalter im jeweiligen Workspace; unterstützt werden OpenAI, OpenRouter und Anthropic. Der Graph, die manuelle Bearbeitung und das MCP-Tool funktionieren auch ganz ohne LLM-Schlüssel. + +➡️ **[Anleitung zu Knowledge Graph & KI-Skills →](docs/knowledge-graph.md)** + +--- + + + +## Bestimme, was das Modell sieht + +Für jedes Tool lässt sich **genau festlegen, welche Felder deine Infrastruktur verlassen**. Das Mapping wird pro Tool hinterlegt und auf die ausgehende Antwort angewendet. Der KI-Client — und das dahinterliegende Modell eines Drittanbieters — erhält damit nur die von dir freigegebene Datenstruktur. + +- **Entferne, was bei dir bleiben soll.** Gib die zu entfernenden Pfade an. Die entsprechenden Felder werden vor der Übergabe an den Agenten herausgefiltert: etwa die IBAN eines Kunden, das Gehalt eines Mitarbeiters oder ein Zugriffstoken, das eine API zusammen mit den Daten zurückgibt. +- **Oder definiere die gesamte Ausgabe.** Eine `select`-Vorlage legt fest, welche Felder erhalten bleiben und wie sie heißen sollen. Für Umformungen, die eine solche Vorlage nicht abdeckt, steht ein JMESPath-Ausdruck zur Verfügung. Wenn eine stabile Struktur für den Agenten hilfreicher ist, ersetze den Wert durch einen Platzhalter (`"iban": "= [redacted]"`), statt das Feld zu entfernen. +- **Prüfe das Ergebnis vor dem Speichern.** Der Editor wendet das Mapping auf eine echte Antwort an und zeigt Original und Ergebnis samt Größenunterschied nebeneinander. Bei einem mitgelieferten Adapter ergibt eine Antwort mit vier Zügen **12.172 B → 1.072 B (−91 %)**. +- **Standardmäßig wird bei Fehlern die Rohantwort weitergegeben — das wird ausdrücklich so benannt.** Schlägt ein Mapping zur Laufzeit fehl, werden die unveränderte Antwort und eine Warnung ausgegeben, damit ein einzelner fehlerhafter Ausdruck ein funktionierendes Tool nicht lahmlegt. Für Felder, die die Infrastruktur unter keinen Umständen verlassen dürfen, ist dieser Standard ungeeignet: Setze bei diesen Tools **`"fallbackToRaw": false`**. Ein fehlerhaftes Mapping lässt dann den Aufruf scheitern, statt die Daten ungefiltert weiterzugeben. + +Das bringt zwei Vorteile zugleich: Sensible Felder gelangen nicht zum Modell, und jedes entfernte Feld spart Kosten im Kontextfenster. + +```json +{ + "transform": { + "mode": "select", + "fallbackToRaw": false, + "exclude": ["customer.iban", "customer.taxId"], + "select": { "order": "$.id", "total": "$.amounts.gross", "status": "$.state" } + } +} +``` + +> Das Audit-Log speichert weiterhin die vollständige Antwort des angebundenen Systems in deiner eigenen Datenbank. Die Begrenzung dessen, was der Agent sieht, geht somit nicht zulasten des Nachweises, was die API tatsächlich zurückgegeben hat. + +➡️ **[Referenz zum Response-Mapping →](docs/tool-definition.md#3-response-mapping-optional)** + +--- + +## Eigene Claude-Connectors erstellen — ohne Code + +Claude unterstützt **benutzerdefinierte Connectors**: entfernte MCP-Server, die du einmal unter *Settings → Connectors* hinzufügst und anschließend in Claude.ai, Claude Desktop und Claude Code nutzen kannst. AnythingMCP erzeugt einen solchen Connector **aus jeder bereits vorhandenen API** — ohne dass du einen MCP-Server programmieren musst: + +1. Importiere deine API-Spezifikation oder wähle einen fertigen Adapter. +2. Passe Tool-Namen, Beschreibungen und Parameter im **visuellen Editor** an — du bestimmst, was die KI sieht. +3. Füge die URL deines MCP-Servers als benutzerdefinierten Connector in Claude hinzu (OAuth 2.0 wird direkt unterstützt). + +Deine Zugangsdaten bleiben auf deiner Infrastruktur, jeder Tool-Aufruf erscheint im Audit-Log, und die rollenbasierte Zugriffskontrolle legt fest, welche Benutzer welche Tools sehen. [Schritt-für-Schritt-Anleitung →](docs/integrations/claude.md) + +--- + +## Deine API als ChatGPT-App bereitstellen + +**Apps in ChatGPT basieren auf MCP.** AnythingMCP liefert das dazugehörige MCP-Backend, ohne dass du es selbst schreiben musst. Verweise auf deinen REST-, SOAP-, GraphQL- oder Datenbank-Endpunkt, und du erhältst einen für ChatGPT geeigneten Connector. Füge ihn in den ChatGPT-Einstellungen hinzu oder verwende ihn als Tool-Schicht einer Apps-SDK-App, damit ChatGPT deine Geschäftsdaten lesen und mit ihnen arbeiten kann. + +Derselbe Connector funktioniert gleichzeitig in **Claude, ChatGPT, Gemini, Copilot und Cursor** — einmal erstellen, überall verbinden. [ChatGPT-Einrichtungsanleitung →](docs/integrations/chatgpt.md) + +--- + +## Warum AnythingMCP? + +KI-Clients sprechen MCP, deine Systeme dagegen REST, SOAP, GraphQL und SQL. Einen eigenen MCP-Server pro System zu schreiben und zu warten — einschließlich Authentifizierung, Audit und Zugriffskontrolle — kostet jeweils Wochen. AnythingMCP bildet die No-Code-Schicht dazwischen: + +| Problem | Lösung | +|---|---| +| Du hast REST-APIs, aber KI-Clients sprechen MCP | **REST → MCP** mit OpenAPI-/Swagger-Import | +| Du hast ältere SOAP-/WSDL-Dienste | **SOAP → MCP** mit automatischem WSDL-Parsing | +| Du möchtest Datenbanken über KI-Agenten abfragen | **DB → MCP** mit automatisch erzeugten Abfrage-Tools (7 Engines) | +| Du möchtest einen Endpunkt für alle APIs | **MCP-Middleware**, die mehrere Connectors zusammenführt | +| Du brauchst einen MCP-Server für Deutsche Bahn / DHL / weclapp / … | **Der Adapterkatalog** — in einer Minute installieren und Zugangsdaten hinterlegen | +| Du kannst Zugangsdaten keinem Drittanbieter überlassen | **Betrieb auf deiner Infrastruktur**, Zugangsdaten mit AES-256-GCM verschlüsselt gespeichert | +| Du brauchst Authentifizierung, Audit-Logs und RBAC | **OAuth2, Audit-Log und rollenbasierter Zugriff** sind eingebaut | +| Ein Modell eines Drittanbieters würde jedes Feld der API-Antwort sehen | **[Response-Mapping pro Tool](#control-what-the-model-sees)** — Felder entfernen oder umformen, bevor sie dein Netzwerk verlassen | +| Dein Agent ruft Tools in der falschen Reihenfolge auf oder erkennt Beziehungen zwischen Systemen nicht | **[Knowledge Graph & KI-Skills](#knowledge-graph--ai-skills)** — Hinweise zur Aufrufreihenfolge und erlernte Geschäftsregeln als Kontext | + +**Was Menschen damit tatsächlich umsetzen** + +| | Anleitungen | +|---|---| +| Zugverbindungen, aktuelle Verspätungen und Routen abfragen | [Deutsche Bahn](https://anythingmcp.com/guides/deutsche-bahn-to-mcp) | +| Mit Claude auf das ERP zugreifen | [weclapp](https://anythingmcp.com/guides/weclapp-to-mcp) · [Xentral](https://anythingmcp.com/guides/xentral-to-mcp) | +| Pakete verfolgen | [DHL](https://anythingmcp.com/guides/dhl-tracking-to-mcp) · [GLS](https://anythingmcp.com/guides/gls-tracking-to-mcp) | +| Eine Rechnung vor der Zahlung prüfen | [VIES VAT](https://anythingmcp.com/guides/vies-vat-to-mcp) · [Handelsregister](https://anythingmcp.com/guides/handelsregister-to-mcp) | +| Einen KI-Agenten mit reinem Lesezugriff auf eine Produktionsdatenbank ausstatten | [Datenbank-Connectors](docs/connectors/database.md) | +| Einen SOAP-Dienst aus dem Jahr 2009 mit einem Modell von 2026 verbinden | [SOAP → MCP](https://anythingmcp.com/guides/soap-to-mcp) | + +--- + + + +## Der Adapterkatalog + +188 Adapter mit mehr als 1.800 Tools. **26 benötigen keinen API-Schlüssel**. Bei den übrigen gibst du deine Zugangsdaten beim Import an; danach stehen die Tools sofort bereit. Für jeden Adapter gibt es auf [anythingmcp.com/guides](https://anythingmcp.com/guides) eine Einrichtungsanleitung in sieben Sprachen. + +| Kategorie | Beispiele | +|---|---| +| 📦 Logistik & Versand | Deutsche Bahn, DHL, DPD, GLS, Shipcloud, Sendcloud | +| 💼 ERP, Buchhaltung & Rechnungsstellung | weclapp, Xentral, DATEV, Scopevisio, Billomat, FastBill | +| 🛍️ E-Commerce | Amazon Seller, Etsy, Shopware 6, WooCommerce, Mercado Libre 🌎, Oxomi | +| 👥 Personalwesen & Außendienst | Personio, HRWorks, Kenjo, MFR Mobile Field Report | +| 🏛️ Behörden & öffentliche Daten | VIES VAT, Handelsregister, UK Companies House 🇬🇧, DESTATIS, Bundesbank, OpenPLZ, NINA | +| 🏦 Banking & Zahlungen | N26, Wise 🇬🇧, PAYONE, Razorpay 🇮🇳, Paystack 🇳🇬 | +| 💬 Messaging & Kommunikation | WhatsApp, LINE 🇯🇵, TeamViewer | +| 🎾 Sport & Web3 | Playtomic, Sorare | +| 🏗️ Bauwesen & Karten | PlanRadar, HERE Geocoding | + +**Ein Adapter besteht aus einer einzigen JSON-Datei.** Deshalb konnte der Katalog so groß werden, und deshalb eignet sich ein neuer Adapter gut als erster Beitrag. Fehlt deiner? [Schlage ihn vor](https://github.com/HelpCode-ai/anythingmcp/issues/new?template=adapter_request.yml) — wir priorisieren nach 👍 — oder [erstelle ihn selbst](CONTRIBUTING.md). + +--- + +## Anleitungen, Client-Einrichtung & FAQ + +➡️ **[docs/guides.md](docs/guides.md)** — Einrichtung von Claude / ChatGPT / Gemini / Copilot / Cursor · Anleitungen für REST-, SOAP-, GraphQL-, Datenbank- und MCP-Brücken-Connectors · API-Referenz & Deployment-Dokumentation · FAQ. + +Du suchst einen bestimmten Dienst? Für jeden Adapter gibt es eine Schritt-für-Schritt-Anleitung auf **[anythingmcp.com/guides](https://anythingmcp.com/guides)**. + +## Community & Unterstützung + +- 💬 **Fragen & Diskussionen** — [GitHub Discussions](https://github.com/HelpCode-ai/anythingmcp/discussions) — stimme über den nächsten Adapter ab und zeige, was du gebaut hast. +- 🐛 **Fehler / 💡 Funktionswünsche** — [Issues](https://github.com/HelpCode-ai/anythingmcp/issues) · 🆘 [SUPPORT.md](SUPPORT.md) +- 🔐 **Sicherheit** — eröffne dafür bitte kein öffentliches Issue; befolge [SECURITY.md](SECURITY.md). +- 🏢 Entwickelt von [helpcode.ai](https://helpcode.ai) in Freiburg, Deutschland. KI-gestützte Entwicklung mit menschlicher Prüfung — [AUTHORS.md](AUTHORS.md) beschreibt, welche Teile das betrifft und wie wir vorgehen. + +## Mitwirken + +Lies die [Beitragsrichtlinien](CONTRIBUTING.md), bevor du einen PR eröffnest. Der einfachste nützliche Beitrag ist ein Adapter: eine JSON-Datei. Dazu gibt es ein [Issue mit einer Schritt-für-Schritt-Anleitung](https://github.com/HelpCode-ai/anythingmcp/issues/150). + +## License + +**Open source** under the [GNU Affero General Public License v3](LICENSE) (AGPL-3.0-only). Commercial use inside your own company is included and always was; the copyleft obligation only starts if you modify AnythingMCP and offer the modified version to others over a network. Cloud-operator code under `ee/` is separately licensed and is not required for self-hosting — see the [License FAQ](docs/license-faq.md). + + +--- + +

+ ⭐ Wenn dir das eine Woche MCP-Server-Entwicklung erspart hat, gib dem Projekt einen Stern.
+ Über Sterne finden andere das Projekt — und wir entscheiden daran mit, welchen Adapter wir als Nächstes entwickeln. +

+ +

+ + Entwicklung der Sterne + +

+ +

+ + Mitwirkende + +

diff --git a/README.ja.md b/README.ja.md new file mode 100644 index 00000000..b82da008 --- /dev/null +++ b/README.ja.md @@ -0,0 +1,294 @@ +

+ AnythingMCP — 188 のコネクター、うち 26 は API キー不要。REST、SOAP/WSDL、GraphQL、SQL、MCP システムを Claude、ChatGPT、Copilot、Gemini 用のツールにします。 +

+ +

AnythingMCP

+ +

+ English · Deutsch · 简体中文 · 日本語 +

+ +

+ Claude、ChatGPT、Copilot から、企業で既に使っているソフトウェアへ安全にアクセスできます。
+ 188 種類の既製アダプターに加え、REST・SOAP・GraphQL・SQL の各システムをコードを書かずに接続。自社のインフラ上で動作し、システム同士のつながりも学習します。 +

+ +

+ GitHub Stars + Release + Open source, AGPL-3.0 + Docker pulls +

+ +**これまでチャットボットでは答えられなかった質問に、Claude が回答します。** 必要なデータが、MCP ではなく REST を使うフィールドサービスシステムに保存されている場合でも対応できます。 + +

+ 技術者が先週訪問した会社についての質問に答えるため、Claude が稼働中のフィールドサービスシステムに接続する AnythingMCP のツールを呼び出している様子。 +

+ +**自分で動かす** — 3 行のコマンドで、リポジトリのクローンは不要です。[詳しい手順はこちら](#run-it-yourself)。 + +```bash +mkdir anythingmcp && cd anythingmcp +curl -fsSLo docker-compose.yml \ + https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml +printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env +docker compose up -d # → http://localhost:3000 +``` + +--- + +この文書で繰り返し使う 3 つの用語は、それぞれ異なるものを指します。 + +- **アダプター（adapter）**は、このリポジトリに含まれる 188 個の JSON 定義のいずれかです。DATEV、weclapp、DHL、Deutsche Bahn、Shopware、Personio、Handelsregister などがあります。そのうち 26 個は API キーを一切必要とせず、それ以外はインポート時に認証情報を設定します。 +- **コネクター（connector）**は、アダプター、または独自の OpenAPI 仕様・Postman コレクション・WSDL・GraphQL エンドポイント・データベースを、ワークスペース内で設定したものです。接続先を指定すれば、MCP サーバーを書くことなく数分で設定できます。 +- **MCP サーバー**は、Claude に渡す URL です。そのサーバーに割り当てたコネクターだけを公開します。 + +すべてが自社のインフラ上で動くため、外部へ出すデータを自分で決められます。ツールごとのレスポンスマッピングで、モデルに渡せるフィールドを定義できます。認証情報は AES-256-GCM で暗号化して保存し、監査ログには上流システムの完全な応答を自社側で保持します。OAuth2、RBAC、SSO、SCIM はセルフホスト版に含まれており、有料プラン専用の機能ではありません。 + +**[KOCH Freiburg GmbH](https://www.kochfreiburg.de/) で本番稼働しています。** 同社では AI アシスタントを ERP、CRM、SOAP サービス、オンプレミスのデータベースなど、15 以上の社内システムに接続しています。ドイツ・フライブルクの [helpcode.ai](https://helpcode.ai) がこのシステムから AnythingMCP を切り出し、オープンソースとして公開しました。アダプターカタログは、単一の製品としてよりも、コミュニティで育てるほうが速く成長するからです。 + +--- + + + +## 自分で動かす + +**以下が推奨の方法です。** 後述の計測もこの方法で行っています。Docker 24+ と `openssl` が必要です。macOS では、先に Docker Desktop を起動してください。 + +```bash +mkdir anythingmcp && cd anythingmcp +curl -fsSLo docker-compose.yml \ + https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml +printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env +docker compose up -d +``` + + を開いて登録します。**最初のアカウントが管理者になります。** + +> **生成された `.env` を保管してください。** 保存した認証情報を復号するには `ENCRYPTION_KEY` が必要です。紛失すると、すべてのコネクターの認証情報を再設定しなければなりません。他のシークレットと同じようにバックアップしてください。 + +| サービス | 既定の URL | +|---|---| +| Web UI | `http://localhost:3000` | +| MCP エンドポイント | `http://localhost:4000/mcp` | +| Swagger ドキュメント | `http://localhost:4000/api/docs` | + +*amd64 での計測結果：イメージの取得に 31 秒、API が正常に動作してログインページが表示されるまでに 24 秒。現在、公開イメージは amd64 のみをサポートしています。Compose ファイルでプラットフォームを明示しているため、Apple Silicon でも Docker Desktop のエミュレーションを使って実行できます。M シリーズ搭載ノートパソコンでは同じ起動に 24 秒かかりましたが、古いハードウェアでは数分かかる場合があります。* + +クイックスタートでは、意図的に `127.0.0.1` にバインドしています。前段に TLS を終端する仕組みがまだないためです。**他の人やクラウドの AI クライアントからアクセスできるインスタンスが必要な場合**は、リポジトリをクローンして `./setup.sh` を実行してください。ドメインを入力すると、Caddy による証明書の取得、シークレットの生成、MCP 認証モードの設定を行います。[デプロイガイド](docs/deployment.md)を参照してください。 + +
+その他のデプロイ方法 — マネージドクラウド、Railway、DigitalOcean + +
+ +[**AnythingMCP Cloud**](https://cloud.anythingmcp.com) は同じ AGPL コードを使い、私たちが**ドイツ・フランクフルト**で運用しています。インフラを用意せずに自社の API で試し、認証情報を社内に置きたくなったらセルフホストへ移行できます。どちらでも使うコネクターは同じです。DPA/AVV は [info@helpcode.ai](mailto:info@helpcode.ai) へのご依頼に応じて提供します。SSO と SCIM はセルフホスト版でのみ利用できます。 + +[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/8-X4WD?referralCode=k30bPV&utm_medium=integration&utm_source=template&utm_campaign=generic) +  +[![Install on DigitalOcean](https://www.deploytodo.com/do-btn-blue.svg)](https://marketplace.digitalocean.com/apps/anythingmcp) + +
+ +--- + +## 接続・管理・学習できること + +### 接続 + +- **5 種類のコネクター** — [REST](docs/connectors/rest.md)、[SOAP](docs/connectors/soap.md)、[GraphQL](docs/connectors/graphql.md)、[データベース](docs/connectors/database.md)、[MCP 間のブリッジ](docs/connectors/mcp-bridge.md)。データベースは PostgreSQL、MySQL、MariaDB、MSSQL、Oracle、MongoDB、SQLite の 7 エンジンに対応しています。 +- **既存の情報からインポート** — OpenAPI/Swagger、Postman、cURL、WSDL、GraphQL イントロスペクションに対応し、稼働中の MCP サーバーから直接ツールを検出することもできます。 +- **アダプターカタログ** — [同梱されているアダプターを確認する](#the-adapter-catalog)。 +- **ビジュアルツールエディター** — パラメーターをパス、クエリ、リクエストボディ、ヘッダーに対応付けられます。ツールの名前や説明を調整し、AI が意図したとおりに理解できるようにします。 +- **動的な MCP サーバー** — ツールは実行時に登録されるため、再起動は不要です。コネクターごとに `{{VAR}}` を展開でき、その値は AI から隠されます。 + +### 管理 + +- **[レスポンスの整形](#control-what-the-model-sees)** — モデルへ渡すフィールドをツールごとに正確に指定し、変更前後の内容をリアルタイムで確認できます。 +- **必要な箇所を読み取り専用に。** 各ツールには、操作から導出される MCP アノテーション（`readOnlyHint`、`destructiveHint`）が付き、ツール単位で上書きできます。クライアントは、請求書の読み取りとクレジットノートの発行を区別して表示できます。ロールに基づくツールの許可リストを使えば、読み取りしかできない MCP サーバーを公開できます。ERP の導入では、多くの場合ここから始めるのが適切です。 +- **幅広い認証方式** — OAuth2（PKCE と Client Credentials）、Bearer、API Key、Basic、WS-Security、クライアント証明書、[LOGIN_TOKEN](docs/connectors/login-token-auth.md)、OAuth 1.0a に対応しています。 +- **監査ログ** — すべてのツール呼び出しについて、入力、出力、所要時間、ステータスを自社のデータベースに記録します。 +- **[SSO](docs/sso.md) と [SCIM](docs/scim-entra-setup.md)** — Entra ID、Google、Okta、Auth0、汎用 OIDC に対応しています。サインインのたびにディレクトリのグループからロールを同期します。ディレクトリでユーザーを無効にすると、そのユーザーのワークスペースへのアクセスと MCP API キーも無効になります（セルフホスト版のみ）。 + +### 学習 + +- **[ナレッジグラフ](docs/knowledge-graph.md)** — コネクターのデータ同士の関係を、個人識別情報（PII）を保護しながらワークスペースごとに整理します。MCP ツールとしてエージェントに返すことで、複数のシステムにまたがる呼び出しを正しくつなげられます。 +- **[AI スキル](docs/knowledge-graph.md)** — 繰り返される利用パターンを小さな再利用可能なルールに変え、サーバーの指示に組み込みます。追加のツール呼び出しをせずにエージェントを導けます（任意のオプトイン機能）。 + +--- + +## 他のプロジェクトとの比較 + +AnythingMCP と比較されるプロジェクトの多くは、MCP ゲートウェイです。既にある MCP サーバーをまとめ、公開範囲を限定し、安全に運用するためのものです。AnythingMCP はその一段階前から始めます。多くの企業にあるのは MCP サーバーではなく、REST API、2009 年の SOAP サービス、そして直接公開したくないデータベースだからです。以下のプロジェクトはいずれも実際の問題を解決していますが、扱う問題は同じではありません。 + +| | どのようなものか | こちらを選ぶとよい場合 | +|---|---|---| +| **[ContextForge](https://github.com/IBM/mcp-context-forge)**（IBM） | 既存の MCP サーバーの前段に置くフェデレーション機能とレジストリー | ツールが既に MCP サーバーとして提供されていて、フェデレーション、仮想サーバー、レジストリーが必要な場合 | +| **[Docker MCP Gateway](https://github.com/docker/mcp-gateway)** | カタログ内の MCP サーバーを、シークレット管理付きのコンテナーとして単一のエンドポイントの背後で実行 | ベンダー公開の MCP サーバーを Docker 内に隔離したく、公開カタログで要件を満たせる場合 | +| **[MetaMCP](https://github.com/metatool-ai/metamcp)** | 名前空間で分離したエンドポイントとミドルウェア層に MCP サーバーを集約 | 主に既存の MCP サーバーをクライアントごとにグループ化し、公開範囲を再設定したい場合 | +| **[Composio](https://github.com/ComposioHQ/composio)** | 認証を代行するマネージド連携のホスト型カタログ | 固定のマネージドカタログで十分で、独自の SOAP サービス、社内 API、データベースを追加する必要がない場合 | +| **AnythingMCP** | 既に運用している API、SOAP サービス、データベースを MCP ツールに変換 | システムが**まだ MCP サーバーではなく**、認証情報を自分で管理する選択肢を持ちたい場合 | + +機能を詳しく比較した表は [anythingmcp.com/vs](https://anythingmcp.com/vs) にあります。 + +--- + + + +## ナレッジグラフと AI スキル + +呼び出しを転送するだけでは、難しい判断はエージェントに残ります。次にどのツールを呼ぶべきか、業務でいう「未完了の注文」や「アクティブな顧客」が実際に何を意味するのか、といった判断です。AnythingMCP は、**コネクター内のデータ同士の関係**と、**チームが実際にツールをどう使っているか**の両方を学習します。そして追加のツール呼び出しではなく、コンテキストとして AI クライアントへ返します。 + +- **ナレッジグラフ** — 顧客、注文、商品などの*エンティティ*と、その*関係*をワークスペースごとに整理します。ツール名、パラメーター、実際の呼び出しの入出力から自動で構築されます。オプションの AI 分析では、ヒューリスティックで捉えられないコネクター間のつながりを推定します。**PII を保護する設計**で、保存するのはエンティティやフィールドの*名前*と関係のメタデータだけです。値そのものは保存しません。 +- **視覚的に構築** — グラフエディターでエンティティや接続を手動で作成、編集、削除できます。説明を追加し、AI の提案を確認して調整することもできます。 +- **MCP 経由で提供** — 各サーバーは `kg_how_to_obtain` ツールを公開します。*利用者側の*エージェントが「Shopware の注文から DHL の追跡番号を取得するには？」と尋ねると、コネクターをつなぐためのヒントを受け取れます。 +- **実際の利用から生まれる AI スキル** — 意図の記録を有効にすると、各ツール呼び出しで*なぜ呼び出したのか*を記録できます。AI 分析が繰り返し現れるパターンを、*「今日の売上にはステータス 2、3、4 の注文を含める」*といった小さな再利用可能なルールに変えます。各ルールを適用、編集、却下することも、信頼度の高いものを自動適用することもできます。適用済みのスキルは、提供時に MCP サーバーの**指示**へ組み込まれるため、**ツール呼び出しを一度も追加せずに**エージェントを導けます。システムの利用を通じて蓄積した知識を、個人の頭の中だけに留めずに済みます。 + +AI 分析は**既定では無効**です。全体の環境変数フラグ*と*ワークスペースごとのスイッチで有効にし、OpenAI、OpenRouter、Anthropic を利用できます。グラフ、手動編集、MCP ツール自体は、LLM キーなしで使えます。 + +➡️ **[ナレッジグラフと AI スキルのガイド →](docs/knowledge-graph.md)** + +--- + + + +## モデルに見せる内容を制御する + +各ツールで、**どのフィールドが自社のインフラの外に出るかを正確に定義**できます。マッピングはツールごとに設定され、応答の送信時に適用されます。AI クライアントと、その背後にあるサードパーティーのモデルには、承認したデータ構造だけが渡ります。 + +- **外部に出すべきでないものを削除。** 削除するパスを指定すると、エージェントへ応答を渡す前に除去されます。顧客の IBAN、従業員の給与、API がデータと一緒に返すアクセストークンなどが対象になります。 +- **出力全体を定義することも可能。** `select` テンプレートで、残すフィールドと出力名を指定します。テンプレートで表現できない変換には JMESPath 式を使えます。エージェントにとって構造が安定しているほうが扱いやすい場合は、フィールドを削除せず、値をプレースホルダー（`"iban": "= [redacted]"`）に置き換えます。 +- **保存前に結果を確認。** エディターが実際の応答にマッピングを適用し、変換前後の内容とサイズの差を並べて表示します。同梱アダプターの一例では、列車 4 件の結果で **12,172 B → 1,072 B（91% 削減）**を計測しています。 +- **既定はフェイルオープンであり、その挙動を明記しています。** 実行時にマッピングが失敗すると、元の応答を返し、警告を記録します。誤った式が 1 つあるだけで、動作していたツール全体が使えなくなるのを防ぐためです。ただし、外部へ絶対に出してはいけないフィールドには、この既定値は適していません。そのようなツールには **`"fallbackToRaw": false`** を設定してください。マッピングが失敗したときは、データをそのまま渡すのではなく、呼び出し自体が失敗します。 + +機密フィールドをモデルに渡さずに済むうえ、削除したフィールドの分だけコンテキストウィンドウの費用も減らせます。 + +```json +{ + "transform": { + "mode": "select", + "fallbackToRaw": false, + "exclude": ["customer.iban", "customer.taxId"], + "select": { "order": "$.id", "total": "$.amounts.gross", "status": "$.state" } + } +} +``` + +> 監査ログには、自社のデータベース内で完全な上流応答が引き続き記録されます。エージェントに見せる内容を調整しても、API が実際に何を返したかという証拠は失われません。 + +➡️ **[レスポンスマッピングのリファレンス →](docs/tool-definition.md#3-response-mapping-optional)** + +--- + +## コードを書かずに独自の Claude コネクターを作る + +Claude は**カスタムコネクター**をサポートしています。*Settings → Connectors* でリモート MCP サーバーを一度追加すると、Claude.ai、Claude Desktop、Claude Code で利用できます。AnythingMCP なら、**既存の任意の API からそのコネクターを作成**でき、MCP サーバーを実装する必要はありません。 + +1. API 仕様をインポートするか、既製のアダプターを選びます。 +2. **ビジュアルエディター**でツール名、説明、パラメーターを調整します。AI に何を見せるかは自分で決められます。 +3. MCP サーバーの URL を Claude のカスタムコネクターとして追加します（OAuth 2.0 を標準でサポート）。 + +認証情報は自社のインフラ上に残り、すべてのツール呼び出しが監査ログに記録されます。どのユーザーがどのツールを利用できるかは、ロールに基づくアクセス制御で管理します。[詳しい手順 →](docs/integrations/claude.md) + +--- + +## API を ChatGPT アプリにする + +**ChatGPT のアプリは MCP を基盤にしています。** AnythingMCP は、その MCP バックエンドを自分で書くことなく用意できます。REST、SOAP、GraphQL、データベースのエンドポイントを指定すれば、ChatGPT で使えるコネクターになります。ChatGPT の設定で追加するか、Apps SDK アプリのツール層として使うことで、ChatGPT が業務データを読み取り、操作できるようになります。 + +同じコネクターを **Claude、ChatGPT、Gemini、Copilot、Cursor** で同時に使えます。一度構築すれば、各クライアントへ接続できます。[ChatGPT の設定ガイド →](docs/integrations/chatgpt.md) + +--- + +## AnythingMCP を使う理由 + +AI クライアントは MCP を使いますが、業務システムは REST、SOAP、GraphQL、SQL を使います。システムごとに専用の MCP サーバーを作成し、認証、監査、アクセス制御まで含めて保守するには、それぞれ数週間かかります。AnythingMCP は、その間をつなぐノーコードの層です。 + +| 課題 | 解決方法 | +|---|---| +| REST API はあるが、AI クライアントは MCP を使う | OpenAPI / Swagger のインポートによる **REST → MCP** 変換 | +| 古い SOAP / WSDL サービスがある | 自動 WSDL 解析による **SOAP → MCP** ブリッジ | +| AI エージェントからデータベースを照会したい | クエリーツールを自動生成する **DB → MCP**（7 エンジン） | +| すべての API を 1 つのエンドポイントにまとめたい | 複数のコネクターを集約する **MCP ミドルウェア** | +| Deutsche Bahn / DHL / weclapp などの MCP サーバーが必要 | **アダプターカタログ**から選び、1 分でインストールして認証情報を設定 | +| 認証情報をサードパーティーへ預けられない | **自社のインフラ上で実行**し、認証情報を AES-256-GCM で暗号化して保存 | +| 認証、監査ログ、RBAC が必要 | **OAuth2、監査ログ、ロールベースのアクセス制御**を標準搭載 | +| サードパーティーのモデルが API 応答の全フィールドを見てしまう | **[ツールごとのレスポンスマッピング](#control-what-the-model-sees)**で、ネットワークの外に出る前にフィールドを削除・整形 | +| エージェントがツールの順序を間違えたり、システム間の関係を見落としたりする | **[ナレッジグラフと AI スキル](#knowledge-graph--ai-skills)**で、呼び出しのつなぎ方と学習した業務ルールをコンテキストとして提供 | + +**実際の活用例** + +| | ガイド | +|---|---| +| 列車、現在の遅延、経路を調べる | [Deutsche Bahn](https://anythingmcp.com/guides/deutsche-bahn-to-mcp) | +| Claude から ERP と対話する | [weclapp](https://anythingmcp.com/guides/weclapp-to-mcp) · [Xentral](https://anythingmcp.com/guides/xentral-to-mcp) | +| 荷物を追跡する | [DHL](https://anythingmcp.com/guides/dhl-tracking-to-mcp) · [GLS](https://anythingmcp.com/guides/gls-tracking-to-mcp) | +| 支払い前に請求書を検証する | [VIES VAT](https://anythingmcp.com/guides/vies-vat-to-mcp) · [Handelsregister](https://anythingmcp.com/guides/handelsregister-to-mcp) | +| エージェントから本番データベースを読み取り専用で使う | [データベースコネクター](docs/connectors/database.md) | +| 2009 年の SOAP サービスを 2026 年のモデルにつなぐ | [SOAP → MCP](https://anythingmcp.com/guides/soap-to-mcp) | + +--- + + + +## アダプターカタログ + +188 個のアダプターで、1,800 以上のツールを公開できます。**26 個は API キーが不要**です。それ以外はインポート時に認証情報を設定すれば、すぐにツールを利用できます。各アダプターには [anythingmcp.com/guides](https://anythingmcp.com/guides) で 7 言語のセットアップガイドを用意しています。 + +| カテゴリー | 例 | +|---|---| +| 📦 物流・配送 | Deutsche Bahn、DHL、DPD、GLS、Shipcloud、Sendcloud | +| 💼 ERP・会計・請求 | weclapp、Xentral、DATEV、Scopevisio、Billomat、FastBill | +| 🛍️ E コマース | Amazon Seller、Etsy、Shopware 6、WooCommerce、Mercado Libre 🌎、Oxomi | +| 👥 人事・フィールドサービス | Personio、HRWorks、Kenjo、MFR Mobile Field Report | +| 🏛️ 行政・公開データ | VIES VAT、Handelsregister、UK Companies House 🇬🇧、DESTATIS、Bundesbank、OpenPLZ、NINA | +| 🏦 銀行・決済 | N26、Wise 🇬🇧、PAYONE、Razorpay 🇮🇳、Paystack 🇳🇬 | +| 💬 メッセージング・通信 | WhatsApp、LINE 🇯🇵、TeamViewer | +| 🎾 スポーツ・Web3 | Playtomic、Sorare | +| 🏗️ 建設・地図 | PlanRadar、HERE Geocoding | + +**アダプターは 1 つの JSON ファイルです。** だからこそカタログをこの規模まで増やすことができ、新しいアダプターの追加は最初の貢献にも適しています。必要なものが見つからない場合は、[リクエスト](https://github.com/HelpCode-ai/anythingmcp/issues/new?template=adapter_request.yml)してください。👍 の数を基に優先順位を決めます。[自分で作成](CONTRIBUTING.md)することもできます。 + +--- + +## ガイド・クライアント設定・FAQ + +➡️ **[docs/guides.md](docs/guides.md)** — Claude / ChatGPT / Gemini / Copilot / Cursor の設定 · REST / SOAP / GraphQL / データベース / MCP ブリッジのコネクターガイド · API リファレンスとデプロイドキュメント · FAQ。 + +特定のサービスを探している場合は、**[anythingmcp.com/guides](https://anythingmcp.com/guides)** に各アダプターの詳しい手順があります。 + +## コミュニティとサポート + +- 💬 **質問・ディスカッション** — [GitHub Discussions](https://github.com/HelpCode-ai/anythingmcp/discussions)で、次に追加するアダプターへ投票したり、作成したものを共有したりできます。 +- 🐛 **不具合 / 💡 機能の提案** — [Issues](https://github.com/HelpCode-ai/anythingmcp/issues) · 🆘 [SUPPORT.md](SUPPORT.md) +- 🔐 **セキュリティ** — 公開 Issue は作成せず、[SECURITY.md](SECURITY.md) の手順に従ってください。 +- 🏢 ドイツ・フライブルクの [helpcode.ai](https://helpcode.ai) が開発しています。AI を活用して開発し、人がレビューしています。対象となる部分や進め方は [AUTHORS.md](AUTHORS.md) に記載しています。 + +## 貢献する + +PR を作成する前に、[貢献ガイド](CONTRIBUTING.md)を読んでください。最も取り組みやすく有用な貢献は、1 つの JSON ファイルからなるアダプターの追加です。そのための[手順を解説した Issue](https://github.com/HelpCode-ai/anythingmcp/issues/150)もあります。 + +## License + +**Open source** under the [GNU Affero General Public License v3](LICENSE) (AGPL-3.0-only). Commercial use inside your own company is included and always was; the copyleft obligation only starts if you modify AnythingMCP and offer the modified version to others over a network. Cloud-operator code under `ee/` is separately licensed and is not required for self-hosting — see the [License FAQ](docs/license-faq.md). + + +--- + +

+ ⭐ MCP サーバーの実装にかかる 1 週間を節約できたら、スターを付けてください。
+ スターは、次の利用者がプロジェクトを見つけるきっかけになり、次に作るアダプターを決める参考にもなります。 +

+ +

+ + スター数の推移 + +

+ +

+ + コントリビューター + +

diff --git a/README.md b/README.md index da503bbb..60a96963 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,10 @@

AnythingMCP

+

+ English · Deutsch · 简体中文 · 日本語 +

+

Give Claude, ChatGPT and Copilot safe access to the software your company already runs.
188 ready adapters, any REST/SOAP/GraphQL/SQL system without code, on your own infrastructure — and it learns how your systems connect. diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 00000000..36edda3b --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,294 @@ +

+ AnythingMCP — 188 个连接器，其中 26 个无需 API 密钥。将 REST、SOAP/WSDL、GraphQL、SQL 和 MCP 系统转化为 Claude、ChatGPT、Copilot 和 Gemini 的工具。 +

+ +

AnythingMCP

+ +

+ English · Deutsch · 简体中文 · 日本語 +

+ +

+ 让 Claude、ChatGPT 和 Copilot 安全访问企业已经在使用的软件。
+ 188 个现成适配器，无需编写代码即可连接任意 REST、SOAP、GraphQL 或 SQL 系统，全部运行在你自己的基础设施上，并能学习各个系统之间的关系。 +

+ +

+ GitHub Stars + Release + Open source, AGPL-3.0 + Docker pulls +

+ +**Claude 回答了一个此前聊天机器人无法回答的问题**，因为相关数据位于使用 REST 而非 MCP 的现场服务系统中： + +

+ Claude 回答某位技术人员上周走访了哪些公司的问题，并调用 AnythingMCP 针对实际运行中的现场服务系统提供的工具。 +

+ +**自己运行试试** — 三行命令，无需克隆仓库，[详细说明见下文](#run-it-yourself)： + +```bash +mkdir anythingmcp && cd anythingmcp +curl -fsSLo docker-compose.yml \ + https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml +printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env +docker compose up -d # → http://localhost:3000 +``` + +--- + +本文反复使用的三个术语，分别指不同的概念： + +- **适配器（adapter）**：本仓库随附的 188 个 JSON 定义之一，例如 DATEV、weclapp、DHL、Deutsche Bahn、Shopware、Personio、Handelsregister 等。其中 26 个完全不需要 API 密钥，其余适配器会在导入时要求你提供相应凭据。 +- **连接器（connector）**：在工作区中配置好的适配器，或你自己的 OpenAPI 规范、Postman 集合、WSDL、GraphQL 端点或数据库。只要有可连接的目标，就能在几分钟内完成配置，无需编写 MCP 服务器。 +- **MCP 服务器**：你提供给 Claude 的那个 URL。它只公开分配给它的连接器，不会公开其他连接器。 + +所有组件都运行在你自己的基础设施上，因此你可以决定哪些数据能够离开它。每个工具的响应映射定义哪些字段可以到达模型；凭据以 AES-256-GCM 加密存储；完整的上游响应则保存在你自己的审计日志中。OAuth2、RBAC、SSO 和 SCIM 已包含在自行托管版本中，并非付费套餐专属功能。 + +**[KOCH Freiburg GmbH](https://www.kochfreiburg.de/) 已在生产环境使用 AnythingMCP**，将 AI 助手连接到 15 个以上的内部系统，包括 ERP、CRM、SOAP 服务和本地数据库。德国弗赖堡的 [helpcode.ai](https://helpcode.ai) 将 AnythingMCP 从该系统中提取出来并开源，因为适配器目录由社区共同建设，比作为单一产品发展得更快。 + +--- + + + +## 自己运行 + +**推荐使用以下方式**，下方的性能测量也基于此方式。需要 Docker 24+ 和 `openssl`；在 macOS 上，请先启动 Docker Desktop。 + +```bash +mkdir anythingmcp && cd anythingmcp +curl -fsSLo docker-compose.yml \ + https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml +printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env +docker compose up -d +``` + +打开 并注册 — **第一个账户将成为管理员**。 + +> **请妥善保存生成的 `.env` 文件。** `ENCRYPTION_KEY` 用于解密已存储的凭据。如果丢失它，就必须重新为每个连接器配置凭据。请将其备份到你保存其他机密信息的位置。 + +| 服务 | 默认 URL | +|---|---| +| Web 界面 | `http://localhost:3000` | +| MCP 端点 | `http://localhost:4000/mcp` | +| Swagger 文档 | `http://localhost:4000/api/docs` | + +*amd64 实测：拉取镜像耗时 31 秒，API 就绪并显示登录页面耗时 24 秒。目前发布的镜像仅支持 amd64。Compose 文件明确指定了平台，因此也可以通过 Docker Desktop 的模拟功能在 Apple Silicon 上运行。在一台 M 系列芯片笔记本上，同样的启动过程耗时 24 秒，但在较旧的硬件上可能需要几分钟。* + +快速启动配置有意将服务绑定到 `127.0.0.1`，因为前面还没有负责 TLS 终止的组件。**如果需要让其他人或云端 AI 客户端访问实例**，请克隆仓库并运行 `./setup.sh`。该脚本会询问域名、通过 Caddy 获取证书、生成机密信息，并设置 MCP 认证模式。详见[部署指南](docs/deployment.md)。 + +
+其他部署方式 — 托管云、Railway、DigitalOcean + +
+ +[**AnythingMCP Cloud**](https://cloud.anythingmcp.com) 使用相同的 AGPL 代码，由我们在**德国法兰克福**运营。你可以先在那里连接自己的 API，体验功能，而无需自行准备基础设施；如果之后希望将凭据保留在内部，也可以迁移到自行托管环境，两种方式使用相同的连接器。可通过 [info@helpcode.ai](mailto:info@helpcode.ai) 申请 DPA/AVV。SSO 和 SCIM 仅适用于自行托管版本。 + +[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/8-X4WD?referralCode=k30bPV&utm_medium=integration&utm_source=template&utm_campaign=generic) +  +[![Install on DigitalOcean](https://www.deploytodo.com/do-btn-blue.svg)](https://marketplace.digitalocean.com/apps/anythingmcp) + +
+ +--- + +## 连接、管理与学习 + +### 连接 + +- **5 种连接器类型** — [REST](docs/connectors/rest.md)、[SOAP](docs/connectors/soap.md)、[GraphQL](docs/connectors/graphql.md)、[数据库](docs/connectors/database.md)、[MCP 到 MCP 桥接](docs/connectors/mcp-bridge.md)。支持七种数据库引擎：PostgreSQL、MySQL、MariaDB、MSSQL、Oracle、MongoDB、SQLite。 +- **导入现有资源** — OpenAPI/Swagger、Postman、cURL、WSDL、GraphQL 内省，或直接从运行中的 MCP 服务器发现工具。 +- **适配器目录** — [查看已随附的内容](#the-adapter-catalog)。 +- **可视化工具编辑器** — 将参数映射到路径、查询参数、请求体和请求头；调整工具的名称和描述，让 AI 按照你的意图理解它们。 +- **动态 MCP 服务器** — 工具在运行时注册，无需重启。支持每个连接器独立的 `{{VAR}}` 插值，且对 AI 隐藏。 + +### 管理 + +- **[响应塑形](#control-what-the-model-sees)** — 精确定义每个工具可以向模型提供哪些字段，并实时预览处理前后的结果。 +- **在需要的地方只允许读取。** 每个工具都带有 MCP 注解（`readOnlyHint`、`destructiveHint`），根据操作类型生成，也可以按工具覆盖。因此，客户端能够区分读取发票和开具贷项通知单。基于角色的工具白名单可以让你发布一个只读 MCP 服务器，这也是大多数人在接入 ERP 时应采用的起点。 +- **覆盖常见认证方式** — OAuth2（PKCE 和 Client Credentials）、Bearer、API Key、Basic、WS-Security、客户端证书、[LOGIN_TOKEN](docs/connectors/login-token-auth.md) 和 OAuth 1.0a。 +- **审计日志** — 每次工具调用的输入、输出、耗时和状态都会记录在你自己的数据库中。 +- **[SSO](docs/sso.md) 和 [SCIM](docs/scim-entra-setup.md)** — 支持 Entra ID、Google、Okta、Auth0 及通用 OIDC。每次登录都会从目录服务的用户组同步角色。在目录中停用用户，其工作区访问权限和 MCP API 密钥也会随之失效（仅适用于自行托管版本）。 + +### 学习 + +- **[知识图谱](docs/knowledge-graph.md)** — 为每个工作区维护一张保护个人身份信息（PII）的关系图，展示连接器数据之间的联系，并以 MCP 工具的形式提供给智能体，帮助它正确串联跨系统调用。 +- **[AI 技能](docs/knowledge-graph.md)** — 将重复出现的使用模式转化为简短、可复用的规则，并合并到服务器指令中，使其无需增加工具调用就能引导智能体（可选，需主动启用）。 + +--- + +## AnythingMCP 与其他项目的区别 + +经常被拿来与 AnythingMCP 比较的项目，大多是 MCP 网关：它们聚合、限定访问范围并保护你已经拥有的 MCP 服务器。AnythingMCP 从更早的一步开始，因为大多数企业根本还没有 MCP 服务器，只有 REST API、一个 2009 年的 SOAP 服务，以及不希望直接暴露的数据库。下面的每个项目都在解决实际问题，只是它们解决的并不是同一个问题。 + +| | 项目定位 | 以下情况更适合选择它 | +|---|---|---| +| **[ContextForge](https://github.com/IBM/mcp-context-forge)**（IBM） | 为现有 MCP 服务器提供联邦聚合和注册中心 | 你的工具已经是 MCP 服务器，需要的是联邦聚合、虚拟服务器和注册中心 | +| **[Docker MCP Gateway](https://github.com/docker/mcp-gateway)** | 将目录中的 MCP 服务器作为容器运行在同一个端点后，并处理机密信息 | 你希望将供应商发布的 MCP 服务器隔离在 Docker 中，且现有目录已能满足需求 | +| **[MetaMCP](https://github.com/metatool-ai/metamcp)** | 通过中间件层，将 MCP 服务器聚合到划分了命名空间的端点中 | 你主要需要按客户端对现有 MCP 服务器分组，并重新限定其访问范围 | +| **[Composio](https://github.com/ComposioHQ/composio)** | 提供托管集成目录，并代为处理认证 | 固定的托管目录已足够，且你不需要加入自己的 SOAP 服务、内部 API 或数据库 | +| **AnythingMCP** | 将企业已经运行的 API、SOAP 服务和数据库转化为 MCP 工具 | 你的系统**还不是** MCP 服务器，而且你希望能够选择自行保管凭据 | + +包含完整功能表的逐项比较页面：[anythingmcp.com/vs](https://anythingmcp.com/vs)。 + +--- + + + +## 知识图谱与 AI 技能 + +单纯转发调用，仍会把最困难的部分留给智能体：下一步该调用哪个工具，以及业务中的“未完成订单”或“活跃客户”究竟意味着什么。AnythingMCP 会学习这两方面的内容 — **连接器数据之间的关系**，以及**团队实际使用工具的方式** — 再将其作为上下文提供给 AI 客户端，而不是增加额外的工具调用。 + +- **知识图谱** — 每个工作区都有自己的*实体*（客户、订单、产品等）及其*关系*图。它根据工具名称、参数以及真实调用的输入和输出自动构建；可选的 AI 分析能够推断出启发式规则遗漏的跨连接器关系。它保持 **PII 安全**：只存储实体和字段的*名称*以及关系元数据，绝不存储具体值。 +- **可视化构建** — 图编辑器允许你手动创建、编辑和删除实体及关系，添加描述，并审核 AI 提出的建议。 +- **通过 MCP 提供** — 每个服务器都公开一个 `kg_how_to_obtain` 工具，让*客户的*智能体可以询问“如何从 Shopware 订单找到 DHL 运单号？”，并获得连接器调用链的提示。 +- **从实际使用中生成 AI 技能** — 启用意图记录后，每次工具调用都能记录*为什么*进行这次调用。AI 分析会将重复模式转化为简短、可复用的规则，例如*“今天的营收包括状态为 2、3 和 4 的订单”*。你可以逐条应用、编辑或忽略规则，也可以让系统自动应用置信度高的建议。已应用的技能会在提供服务时合并到 MCP 服务器的**指令**中，**无需增加任何工具调用**就能引导智能体。团队通过使用系统积累的知识，不再只保存在个人的脑海中。 + +AI 分析**默认关闭**。需要同时启用全局环境变量开关*和*工作区开关，可使用 OpenAI、OpenRouter 或 Anthropic。知识图谱、手动编辑和 MCP 工具本身完全不需要 LLM 密钥。 + +➡️ **[知识图谱与 AI 技能指南 →](docs/knowledge-graph.md)** + +--- + + + +## 控制模型能够看到的内容 + +每个工具都可以**精确定义哪些字段能够离开你的基础设施**。映射按工具配置，并在响应发出前应用。因此，AI 客户端及其背后的第三方模型只能收到你批准的数据结构。 + +- **删除不应外传的字段。** 列出需要删除的路径，在响应到达智能体之前将其移除，例如客户的 IBAN、员工薪资，或 API 随数据一并返回的访问令牌。 +- **也可以定义整个输出。** `select` 模板指定保留哪些字段以及它们的输出名称；模板无法表达的数据重组可以使用 JMESPath 表达式。如果保留稳定的结构更适合智能体，可以用占位符替换值（`"iban": "= [redacted]"`），而不是直接删除字段。 +- **保存之前先查看效果。** 编辑器会对真实响应执行映射，将处理前后结果和大小差异并排显示。某个随附适配器对包含四趟列车的结果进行处理时，测得 **12,172 B → 1,072 B（减少 91%）**。 +- **默认采用失败放行行为，并明确说明这一点。** 如果映射在运行时出错，系统会返回原始响应并记录警告，以免一个错误表达式让原本正常工作的工具不可用。但对于绝不能外传的字段，这个默认行为并不合适：请在相应工具上设置 **`"fallbackToRaw": false`**，使映射出错时调用失败，而不是放行原始数据。 + +这样既能避免敏感字段到达模型，也能减少上下文窗口中需要付费处理的内容。 + +```json +{ + "transform": { + "mode": "select", + "fallbackToRaw": false, + "exclude": ["customer.iban", "customer.taxId"], + "select": { "order": "$.id", "total": "$.amounts.gross", "status": "$.state" } + } +} +``` + +> 审计日志仍会将完整的上游响应保存在你自己的数据库中。调整智能体可以看到的内容，不会导致你失去 API 实际返回内容的证据。 + +➡️ **[响应映射参考 →](docs/tool-definition.md#3-response-mapping-optional)** + +--- + +## 无需代码，创建自定义 Claude 连接器 + +Claude 支持**自定义连接器**：在 *Settings → Connectors* 中添加一次远程 MCP 服务器，即可在 Claude.ai、Claude Desktop 和 Claude Code 中使用。AnythingMCP 可以**从你已有的任意 API 创建这样的连接器**，无需编写 MCP 服务器： + +1. 导入 API 规范，或选择一个预置适配器。 +2. 在**可视化编辑器**中调整工具名称、描述和参数，由你决定 AI 能够看到的内容。 +3. 将 MCP 服务器的 URL 添加为 Claude 的自定义连接器（开箱即支持 OAuth 2.0）。 + +凭据保留在你的基础设施上，每次工具调用都会记录到审计日志中，基于角色的访问控制则决定哪些用户可以看到哪些工具。[分步指南 →](docs/integrations/claude.md) + +--- + +## 将 API 变成 ChatGPT 应用 + +**ChatGPT 中的应用基于 MCP 构建**，AnythingMCP 可以直接提供所需的 MCP 后端。将其指向 REST、SOAP、GraphQL 或数据库端点，即可获得适用于 ChatGPT 的连接器。你可以在 ChatGPT 设置中添加它，或将其作为 Apps SDK 应用的工具层，让 ChatGPT 读取业务数据并执行相应操作。 + +同一个连接器可以同时用于 **Claude、ChatGPT、Gemini、Copilot 和 Cursor**，一次构建，即可在多处连接。[ChatGPT 设置指南 →](docs/integrations/chatgpt.md) + +--- + +## 为什么选择 AnythingMCP？ + +AI 客户端使用 MCP，而你的系统使用 REST、SOAP、GraphQL 和 SQL。为每个系统单独编写和维护 MCP 服务器，同时处理认证、审计和访问控制，每套都可能花费数周。AnythingMCP 就是两者之间的无代码连接层： + +| 问题 | 解决方案 | +|---|---| +| 已有 REST API，但 AI 客户端使用 MCP | 通过 OpenAPI / Swagger 导入实现 **REST → MCP** 转换 | +| 存在旧的 SOAP / WSDL 服务 | 通过自动 WSDL 解析实现 **SOAP → MCP** 桥接 | +| 需要通过 AI 智能体查询数据库 | 自动生成查询工具，实现 **DB → MCP**（7 种引擎） | +| 希望用一个端点访问所有 API | 聚合多个连接器的 **MCP 中间件** | +| 需要 Deutsche Bahn / DHL / weclapp 等服务的 MCP 服务器 | 使用**适配器目录**，一分钟内完成安装并配置凭据 | +| 无法将凭据交给第三方 | **运行在你自己的基础设施上**，凭据以 AES-256-GCM 加密存储 | +| 需要认证、审计日志和 RBAC | 内置 **OAuth2、审计日志和基于角色的访问控制**，无需自行实现 | +| 第三方模型会看到 API 响应中的所有字段 | 使用**[每个工具独立的响应映射](#control-what-the-model-sees)**，在字段离开网络前将其删除或重组 | +| 智能体以错误顺序调用工具，或无法理解两个系统之间的关系 | **[知识图谱与 AI 技能](#knowledge-graph--ai-skills)** 提供调用链提示和学到的业务规则，作为上下文交给智能体 | + +**人们实际用它做什么** + +| | 指南 | +|---|---| +| 查询列车、实时晚点信息和路线 | [Deutsche Bahn](https://anythingmcp.com/guides/deutsche-bahn-to-mcp) | +| 通过 Claude 与 ERP 交互 | [weclapp](https://anythingmcp.com/guides/weclapp-to-mcp) · [Xentral](https://anythingmcp.com/guides/xentral-to-mcp) | +| 追踪包裹 | [DHL](https://anythingmcp.com/guides/dhl-tracking-to-mcp) · [GLS](https://anythingmcp.com/guides/gls-tracking-to-mcp) | +| 付款前核验发票 | [VIES VAT](https://anythingmcp.com/guides/vies-vat-to-mcp) · [Handelsregister](https://anythingmcp.com/guides/handelsregister-to-mcp) | +| 让智能体以只读方式访问生产数据库 | [数据库连接器](docs/connectors/database.md) | +| 将 2009 年的 SOAP 服务连接到 2026 年的模型 | [SOAP → MCP](https://anythingmcp.com/guides/soap-to-mcp) | + +--- + + + +## 适配器目录 + +188 个适配器，提供 1,800 多个工具。**其中 26 个不需要 API 密钥**，其余适配器会在导入时要求提供凭据，导入后工具即可立即使用。每个适配器都在 [anythingmcp.com/guides](https://anythingmcp.com/guides) 上提供七种语言的设置指南。 + +| 分类 | 示例 | +|---|---| +| 📦 物流与配送 | Deutsche Bahn、DHL、DPD、GLS、Shipcloud、Sendcloud | +| 💼 ERP、会计与开票 | weclapp、Xentral、DATEV、Scopevisio、Billomat、FastBill | +| 🛍️ 电子商务 | Amazon Seller、Etsy、Shopware 6、WooCommerce、Mercado Libre 🌎、Oxomi | +| 👥 人力资源与现场服务 | Personio、HRWorks、Kenjo、MFR Mobile Field Report | +| 🏛️ 政务与公开数据 | VIES VAT、Handelsregister、UK Companies House 🇬🇧、DESTATIS、Bundesbank、OpenPLZ、NINA | +| 🏦 银行与支付 | N26、Wise 🇬🇧、PAYONE、Razorpay 🇮🇳、Paystack 🇳🇬 | +| 💬 消息与通信 | WhatsApp、LINE 🇯🇵、TeamViewer | +| 🎾 体育与 Web3 | Playtomic、Sorare | +| 🏗️ 建筑与地图 | PlanRadar、HERE Geocoding | + +**一个适配器就是一个 JSON 文件。** 这既解释了目录为何能够达到现在的规模，也意味着添加适配器很适合作为首次贡献。如果缺少你需要的适配器，可以[提出请求](https://github.com/HelpCode-ai/anythingmcp/issues/new?template=adapter_request.yml)，我们会根据 👍 数量安排优先级；也可以[自己构建](CONTRIBUTING.md)。 + +--- + +## 指南、客户端设置与常见问题 + +➡️ **[docs/guides.md](docs/guides.md)** — Claude / ChatGPT / Gemini / Copilot / Cursor 设置 · REST / SOAP / GraphQL / 数据库 / MCP 桥接连接器指南 · API 参考与部署文档 · 常见问题。 + +在寻找某个具体服务？每个适配器都在 **[anythingmcp.com/guides](https://anythingmcp.com/guides)** 上提供分步指南。 + +## 社区与支持 + +- 💬 **问题与讨论** — [GitHub Discussions](https://github.com/HelpCode-ai/anythingmcp/discussions)，为下一个适配器投票，分享你构建的内容。 +- 🐛 **缺陷 / 💡 功能建议** — [Issues](https://github.com/HelpCode-ai/anythingmcp/issues) · 🆘 [SUPPORT.md](SUPPORT.md) +- 🔐 **安全问题** — 请勿创建公开 Issue，请遵循 [SECURITY.md](SECURITY.md)。 +- 🏢 由德国弗赖堡的 [helpcode.ai](https://helpcode.ai) 开发。开发过程采用 AI 辅助，并由人工审查；[AUTHORS.md](AUTHORS.md) 说明了涉及哪些部分以及具体做法。 + +## 参与贡献 + +创建 PR 前请先阅读[贡献指南](CONTRIBUTING.md)。最容易上手且有实际价值的贡献是适配器：只需要一个 JSON 文件。你可以参考对应的[分步指导 Issue](https://github.com/HelpCode-ai/anythingmcp/issues/150)。 + +## License + +**Open source** under the [GNU Affero General Public License v3](LICENSE) (AGPL-3.0-only). Commercial use inside your own company is included and always was; the copyleft obligation only starts if you modify AnythingMCP and offer the modified version to others over a network. Cloud-operator code under `ee/` is separately licensed and is not required for self-hosting — see the [License FAQ](docs/license-faq.md). + + +--- + +

+ ⭐ 如果这个项目帮你省下了一周编写 MCP 服务器的时间，请给它一个 Star。
+ Star 帮助更多人发现项目，也帮助我们决定接下来构建哪个适配器。 +

+ +

+ + Star 历史 + +

+ +

+ + 贡献者 + +

From feb06447b7df0fd654c5e51f14fba3b16df32e1c Mon Sep 17 00:00:00 2001 From: Matteo Date: Tue, 15 Sep 2026 16:40:24 +0200 Subject: [PATCH 2/2] docs(readme): sync the translations with the current catalog counts main moved to 189 adapters and 20 keyless ones while this PR was open, and fix the doubled 'als' in the German intro. --- README.de.md | 10 +++++----- README.ja.md | 8 ++++---- README.zh-CN.md | 8 ++++---- 3 files changed, 13 insertions(+), 13 deletions(-) diff --git a/README.de.md b/README.de.md index 13dec9d6..fa40f59e 100644 --- a/README.de.md +++ b/README.de.md @@ -1,5 +1,5 @@

- AnythingMCP — 188 Connectors, 26 davon ohne API-Schlüssel. Deine REST-, SOAP/WSDL-, GraphQL-, SQL- und MCP-Systeme werden zu Tools für Claude, ChatGPT, Copilot und Gemini. + AnythingMCP — 189 Connectors, 20 davon ohne API-Schlüssel. Deine REST-, SOAP/WSDL-, GraphQL-, SQL- und MCP-Systeme werden zu Tools für Claude, ChatGPT, Copilot und Gemini.

AnythingMCP

@@ -10,7 +10,7 @@

Gib Claude, ChatGPT und Copilot sicheren Zugriff auf die Software, die dein Unternehmen bereits nutzt.
- 188 fertige Adapter, beliebige REST-/SOAP-/GraphQL-/SQL-Systeme ohne eigenen Code, auf deiner eigenen Infrastruktur — und ein System, das lernt, wie deine Anwendungen zusammenhängen. + 189 fertige Adapter, beliebige REST-/SOAP-/GraphQL-/SQL-Systeme ohne eigenen Code, auf deiner eigenen Infrastruktur — und ein System, das lernt, wie deine Anwendungen zusammenhängen.

@@ -40,13 +40,13 @@ docker compose up -d # → http://localhost:3000 Drei Begriffe tauchen immer wieder auf und bezeichnen unterschiedliche Dinge: -- Ein **Adapter** ist eine der 188 JSON-Definitionen in diesem Repository — DATEV, weclapp, DHL, Deutsche Bahn, Shopware, Personio, Handelsregister und viele weitere. 26 davon benötigen überhaupt keinen API-Schlüssel; bei den anderen gibst du deine Zugangsdaten beim Import an. +- Ein **Adapter** ist eine der 189 JSON-Definitionen in diesem Repository — DATEV, weclapp, DHL, Deutsche Bahn, Shopware, Personio, Handelsregister und viele weitere. 20 davon benötigen überhaupt keinen API-Schlüssel; bei den anderen gibst du deine Zugangsdaten beim Import an. - Ein **Connector** entsteht, wenn du einen Adapter oder deine eigene OpenAPI-Spezifikation, Postman-Collection, WSDL, einen GraphQL-Endpunkt oder eine Datenbank in deinem Workspace konfigurierst. In wenigen Minuten lässt sich so eine Verbindung einrichten, ohne einen MCP-Server zu programmieren. - Ein **MCP-Server** ist die URL, die du Claude übergibst. Er stellt ausschließlich die Connectors bereit, die du ihm zuweist. Alles läuft auf deiner Infrastruktur. Du entscheidest also, welche Daten sie verlassen. Das Response-Mapping legt für jedes Tool fest, welche Felder das Modell erreichen dürfen. Gespeicherte Zugangsdaten werden mit AES-256-GCM verschlüsselt; das Audit-Log bewahrt die vollständige Antwort des angebundenen Systems bei dir auf. OAuth2, RBAC, SSO und SCIM sind im selbst gehosteten Build enthalten und werden nicht einem kostenpflichtigen Tarif vorbehalten. -**Im produktiven Einsatz bei [KOCH Freiburg GmbH](https://www.kochfreiburg.de/)**: Dort verbindet AnythingMCP KI-Assistenten mit mehr als 15 internen Systemen — ERP, CRM, SOAP-Diensten und lokalen Datenbanken. [helpcode.ai](https://helpcode.ai) aus Freiburg hat AnythingMCP aus diesem System herausgelöst und als Open Source veröffentlicht, weil ein Adapterkatalog in einer Community schneller wächst als als einzelnes Produkt. +**Im produktiven Einsatz bei [KOCH Freiburg GmbH](https://www.kochfreiburg.de/)**: Dort verbindet AnythingMCP KI-Assistenten mit mehr als 15 internen Systemen — ERP, CRM, SOAP-Diensten und lokalen Datenbanken. [helpcode.ai](https://helpcode.ai) aus Freiburg hat AnythingMCP aus diesem System herausgelöst und als Open Source veröffentlicht, weil ein Adapterkatalog in einer Community schneller wächst als im Alleingang. --- @@ -234,7 +234,7 @@ KI-Clients sprechen MCP, deine Systeme dagegen REST, SOAP, GraphQL und SQL. Eine ## Der Adapterkatalog -188 Adapter mit mehr als 1.800 Tools. **26 benötigen keinen API-Schlüssel**. Bei den übrigen gibst du deine Zugangsdaten beim Import an; danach stehen die Tools sofort bereit. Für jeden Adapter gibt es auf [anythingmcp.com/guides](https://anythingmcp.com/guides) eine Einrichtungsanleitung in sieben Sprachen. +189 Adapter mit mehr als 1.800 Tools. **20 benötigen keinen API-Schlüssel**. Bei den übrigen gibst du deine Zugangsdaten beim Import an; danach stehen die Tools sofort bereit. Für jeden Adapter gibt es auf [anythingmcp.com/guides](https://anythingmcp.com/guides) eine Einrichtungsanleitung in sieben Sprachen. | Kategorie | Beispiele | |---|---| diff --git a/README.ja.md b/README.ja.md index b82da008..ceab2707 100644 --- a/README.ja.md +++ b/README.ja.md @@ -1,5 +1,5 @@

- AnythingMCP — 188 のコネクター、うち 26 は API キー不要。REST、SOAP/WSDL、GraphQL、SQL、MCP システムを Claude、ChatGPT、Copilot、Gemini 用のツールにします。 + AnythingMCP — 189 のコネクター、うち 20 は API キー不要。REST、SOAP/WSDL、GraphQL、SQL、MCP システムを Claude、ChatGPT、Copilot、Gemini 用のツールにします。

AnythingMCP

@@ -10,7 +10,7 @@

Claude、ChatGPT、Copilot から、企業で既に使っているソフトウェアへ安全にアクセスできます。
- 188 種類の既製アダプターに加え、REST・SOAP・GraphQL・SQL の各システムをコードを書かずに接続。自社のインフラ上で動作し、システム同士のつながりも学習します。 + 189 種類の既製アダプターに加え、REST・SOAP・GraphQL・SQL の各システムをコードを書かずに接続。自社のインフラ上で動作し、システム同士のつながりも学習します。

@@ -40,7 +40,7 @@ docker compose up -d # → http://localhost:3000 この文書で繰り返し使う 3 つの用語は、それぞれ異なるものを指します。 -- **アダプター（adapter）**は、このリポジトリに含まれる 188 個の JSON 定義のいずれかです。DATEV、weclapp、DHL、Deutsche Bahn、Shopware、Personio、Handelsregister などがあります。そのうち 26 個は API キーを一切必要とせず、それ以外はインポート時に認証情報を設定します。 +- **アダプター（adapter）**は、このリポジトリに含まれる 189 個の JSON 定義のいずれかです。DATEV、weclapp、DHL、Deutsche Bahn、Shopware、Personio、Handelsregister などがあります。そのうち 20 個は API キーを一切必要とせず、それ以外はインポート時に認証情報を設定します。 - **コネクター（connector）**は、アダプター、または独自の OpenAPI 仕様・Postman コレクション・WSDL・GraphQL エンドポイント・データベースを、ワークスペース内で設定したものです。接続先を指定すれば、MCP サーバーを書くことなく数分で設定できます。 - **MCP サーバー**は、Claude に渡す URL です。そのサーバーに割り当てたコネクターだけを公開します。 @@ -234,7 +234,7 @@ AI クライアントは MCP を使いますが、業務システムは REST、S ## アダプターカタログ -188 個のアダプターで、1,800 以上のツールを公開できます。**26 個は API キーが不要**です。それ以外はインポート時に認証情報を設定すれば、すぐにツールを利用できます。各アダプターには [anythingmcp.com/guides](https://anythingmcp.com/guides) で 7 言語のセットアップガイドを用意しています。 +189 個のアダプターで、1,800 以上のツールを公開できます。**20 個は API キーが不要**です。それ以外はインポート時に認証情報を設定すれば、すぐにツールを利用できます。各アダプターには [anythingmcp.com/guides](https://anythingmcp.com/guides) で 7 言語のセットアップガイドを用意しています。 | カテゴリー | 例 | |---|---| diff --git a/README.zh-CN.md b/README.zh-CN.md index 36edda3b..339c8f64 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,5 +1,5 @@

- AnythingMCP — 188 个连接器，其中 26 个无需 API 密钥。将 REST、SOAP/WSDL、GraphQL、SQL 和 MCP 系统转化为 Claude、ChatGPT、Copilot 和 Gemini 的工具。 + AnythingMCP — 189 个连接器，其中 20 个无需 API 密钥。将 REST、SOAP/WSDL、GraphQL、SQL 和 MCP 系统转化为 Claude、ChatGPT、Copilot 和 Gemini 的工具。

AnythingMCP

@@ -10,7 +10,7 @@

让 Claude、ChatGPT 和 Copilot 安全访问企业已经在使用的软件。
- 188 个现成适配器，无需编写代码即可连接任意 REST、SOAP、GraphQL 或 SQL 系统，全部运行在你自己的基础设施上，并能学习各个系统之间的关系。 + 189 个现成适配器，无需编写代码即可连接任意 REST、SOAP、GraphQL 或 SQL 系统，全部运行在你自己的基础设施上，并能学习各个系统之间的关系。

@@ -40,7 +40,7 @@ docker compose up -d # → http://localhost:3000 本文反复使用的三个术语，分别指不同的概念： -- **适配器（adapter）**：本仓库随附的 188 个 JSON 定义之一，例如 DATEV、weclapp、DHL、Deutsche Bahn、Shopware、Personio、Handelsregister 等。其中 26 个完全不需要 API 密钥，其余适配器会在导入时要求你提供相应凭据。 +- **适配器（adapter）**：本仓库随附的 189 个 JSON 定义之一，例如 DATEV、weclapp、DHL、Deutsche Bahn、Shopware、Personio、Handelsregister 等。其中 20 个完全不需要 API 密钥，其余适配器会在导入时要求你提供相应凭据。 - **连接器（connector）**：在工作区中配置好的适配器，或你自己的 OpenAPI 规范、Postman 集合、WSDL、GraphQL 端点或数据库。只要有可连接的目标，就能在几分钟内完成配置，无需编写 MCP 服务器。 - **MCP 服务器**：你提供给 Claude 的那个 URL。它只公开分配给它的连接器，不会公开其他连接器。 @@ -234,7 +234,7 @@ AI 客户端使用 MCP，而你的系统使用 REST、SOAP、GraphQL 和 SQL。 ## 适配器目录 -188 个适配器，提供 1,800 多个工具。**其中 26 个不需要 API 密钥**，其余适配器会在导入时要求提供凭据，导入后工具即可立即使用。每个适配器都在 [anythingmcp.com/guides](https://anythingmcp.com/guides) 上提供七种语言的设置指南。 +189 个适配器，提供 1,800 多个工具。**其中 20 个不需要 API 密钥**，其余适配器会在导入时要求提供凭据，导入后工具即可立即使用。每个适配器都在 [anythingmcp.com/guides](https://anythingmcp.com/guides) 上提供七种语言的设置指南。 | 分类 | 示例 | |---|---|