Jentic

Jentic MCP Plugin

Warum Jentic MCP verwenden?

Jentic MCP ermöglicht Entwicklern die schnelle Erkennung und Integration externer APIs und Workflows – ohne dass API-spezifischer Code geschrieben oder gepflegt werden muss. Durch die Nutzung des MCP-Protokolls und der agentenbasierten Laufzeitumgebung von Jentic können Entwickler:

Suchen Sie nach APIs und Workflows nach Funktion, nicht nach Anbieter oder Implementierung.
Generieren Sie sofort Integrationscodebeispiele, die unabhängig von spezifischen API-Details sind.
Vermeiden Sie Standardtexte und reduzieren Sie den Wartungsaufwand, indem Sie auf eine standardisierte, deklarative Integration setzen.
Konzentrieren Sie sich auf die Erstellung von Funktionen, während Jentic MCP die Komplexität der API-Interaktion übernimmt.

API-Tools

Das Jentic MCP Plugin bietet die folgenden Tools:

search_apis : Suche nach APIs im Jentic-Verzeichnis, die bestimmten Funktionsanforderungen entsprechen
load_execution_info : Ruft detaillierte Spezifikationen für APIs und Operationen aus dem Jentic-Verzeichnis ab. Dies beinhaltet Authentifizierungsinformationen, die Sie möglicherweise in Ihrer mcpServers.jentic.env -Konfiguration angeben müssen.
execute : Führen Sie eine bestimmte API- oder Workflow-Operation aus.

Erste Schritte

Die empfohlene Methode ist, den Server direkt aus dem GitHub-Repository mit uvx auszuführen. Sie müssen uv zuerst mit folgendem Befehl installieren:

brew install uv oder pip install uv

Holen Sie sich Ihre Jentic UUID

Um das Jentic SDK nutzen zu können, benötigen Sie zunächst eine Jentic-UUID. Am einfachsten geht das über die Jentic-CLI. Optional können Sie eine E-Mail-Adresse angeben, um höhere Ratenlimits und frühzeitigen Zugriff auf neue Funktionen zu erhalten.

pip install jentic
jentic register --email '<your_email>'

Dadurch werden Ihre UUID und ein Exportbefehl zum Festlegen in Ihrer Umgebung gedruckt:

export JENTIC_UUID=<your-jentic-uuid>

Legen Sie die Jentic-UUID in Ihrer MCP-Clientkonfiguration wie unten gezeigt fest.

Der Speicherort der Konfigurationsdatei hängt vom verwendeten Client und Ihrem Betriebssystem ab. Einige gängige Beispiele:

Windsurf : ~/.codeium/windsurf/mcp_config.json
Claude Desktop : ~/Library/Application Support/Claude/claude_desktop_config.json
Claude-Code : ~/.claude.json
Cursor : ~/cursor/.mcp.json

Informationen zum Hinzufügen von MCP-Servern finden Sie bei anderen Clients in der Dokumentation Ihres Clients.

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "JENTIC_UUID": "<your-jentic-uuid>"
            }
        }
    }
}

Hinweis: Nach dem Speichern der Konfigurationsdatei müssen Sie möglicherweise die Clientanwendung (Windsurf, Claude Desktop) neu starten, damit die Änderungen wirksam werden.

Verwendung des MCP-Tools

Sobald der MCP-Server läuft, können Sie die MCP-Tools in Ihrem LLM-Agenten problemlos verwenden, um APIs und Workflows zu erkennen und auszuführen.

search_apis : Suche nach APIs im Jentic-Verzeichnis, die bestimmten Funktionsanforderungen entsprechen
load_execution_info : Ruft detaillierte Spezifikationen für APIs und Operationen aus dem Jentic-Verzeichnis ab. Dies beinhaltet Authentifizierungsinformationen, die Sie möglicherweise in Ihrer mcpServers.jentic.env -Konfiguration angeben müssen.
execute : Führen Sie eine bestimmte API- oder Workflow-Operation aus.

Umgebungsvariablen

Wenn Sie eine API verwenden, die eine Authentifizierung erfordert, beschreibt das Tool load_execution_info die erforderlichen Umgebungsvariablen. Sie können Umgebungsvariablen über die Kommandozeile in Windsurf einrichten. In einigen Clients wie Claude Desktop müssen Sie sie jedoch Ihrer MCP-Konfiguration hinzufügen:

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "DISCORD_BOTTOKEN=": "YOUR BOT TOKEN"
            }
        }
    }
}

Alternative (Verwendung des lokalen Pfads für die Entwicklung):

Verwenden Sie dies, wenn Sie das MCP-Plugin lokal aktiv entwickeln. Ersetzen Sie /path/to/your/project/mcp durch den absoluten Pfad zu Ihrem Projektverzeichnis.

{
    "mcpServers": {
        "jentic": { 
            "command": "uvx",
            "args": [
                "--from",
                "/path/to/your/project/mcp",
                "mcp" 
            ]
        }
    }
}

Optional: Fügen Sie Ihrer Datei mcp_config.json eine Umgebungsvariable JENTIC_API_URL hinzu, um auf eine bestimmte Jentic-API zu verweisen (funktioniert mit beiden Methoden):

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "JENTIC_API_URL": "https://your-jentic-api.url/"
            }
        }
    }
}

Starten Sie Windsurf nach der Konfiguration neu und die Jentic MCP-Tools sind verfügbar.

Sie können die vom lokal ausgeführten MCP-Server generierten Protokolle verfolgen, indem Sie Folgendes ausführen:

tail /path/to/mcp/jentic_ark2_mcp.log

Installation

Stellen Sie sicher, dass Sie pdm installiert haben ( pipx install pdm ).

So installieren Sie das Paket und seine Abhängigkeiten für die Entwicklung:

# From the project root directory (e.g., /Users/kc/c/sdk/mcp)
pdm install -G dev

Ausführen des MCP-Servers

Das Jentic MCP-Plugin ist für die Ausführung mit uvx konzipiert, das die Einrichtung und Ausführung der Umgebung übernimmt.

Standardmodus (Stdio)

Führen Sie das MCP-Plugin direkt mit uvx aus und geben Sie das Projektverzeichnis als Quelle an, indem Sie --from und das mcp -Skript verwenden:

Vom lokalen Pfad (Entwicklung):

# Use --from with the project directory and specify the 'mcp' script
uvx --from /path/to/your/project/mcp mcp

# Or, if running from within the project directory:
uvx --from . mcp

Aus dem Remote-Repository (für die allgemeine Verwendung empfohlen):

uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  mcp

Dabei wird automatisch der im Rückruf des mcp Skripts definierte Standardbefehl serve --transport stdio verwendet.

HTTP-Modus

So führen Sie den Server im HTTP-Modus aus (z. B. zum Testen mit claude-cli ):

Vom lokalen Pfad (Entwicklung):

# Default HTTP (port 8010)
uvx --from /path/to/your/project/mcp mcp serve --transport http

# With custom port
uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8080

# With custom host
uvx --from /path/to/your/project/mcp mcp serve --transport http --host 0.0.0.0 --port 8080

Aus dem Remote-Repository (empfohlen):

uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  mcp serve --transport http --port 8080

Ausführen von einem Remote-Git-Repository

Sie können den MCP-Server auch direkt von einer Git-Repository-URL aus ausführen, ohne ihn lokal zu klonen, indem Sie uvx --from verwenden:

# Example from a specific branch and subdirectory
uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp

# Explanation:
# - git+https://... .git : The repository URL
# - @main   : The branch, tag, or commit hash
# - #subdirectory=mcp     : The folder within the repo containing the pyproject.toml

Dieser Befehl ruft die angegebene Version ab, installiert ihre Abhängigkeiten in einer temporären Umgebung und führt den Standardbefehl aus ( serve --transport stdio ).

Sie können nach dem URL-Fragment weitere Argumente wie --log-level DEBUG oder --mock hinzufügen:

uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  --log-level DEBUG --mock

So führen Sie die Ausführung im HTTP-Modus von einer Remotequelle aus aus:

uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  serve --transport http --port 8080

Weitere Optionen

Protokollierung

# Set logging level (applies to default stdio or explicit serve)
uvx --from /path/to/your/project/mcp mcp --log-level DEBUG
uvx --from /path/to/your/project/mcp mcp serve --transport http --log-level DEBUG

# Log to file (applies to default stdio or explicit serve)
uvx --from /path/to/your/project/mcp mcp --log-file jentic_mcp.log
uvx --from /path/to/your/project/mcp mcp serve --transport http --log-file jentic_mcp.log

Mock-Modus

Aktivieren Sie den Mock-Modus für die Entwicklung, ohne eine Verbindung zum eigentlichen Jentic API Knowledge Hub herzustellen:

# Mock mode with default stdio
uvx --from /path/to/your/project/mcp mcp --mock

# Mock mode with explicit HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport http --mock

Umgebungsvariablen

Stellen Sie Umgebungsvariablen mithilfe einer .env Datei bereit:

# Env file with default stdio
uvx --from /path/to/your/project/mcp mcp --env-file .env

# Env file with explicit HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport http --env-file .env

Verwendung mit Claude

Das MCP-Plugin kann mit Claude oder anderen LLMs verwendet werden, die die MCP-Spezifikation unterstützen:

Vom Remote-Repository ausführen (empfohlen):

# Run the server in HTTP mode first
uvx --from \
  git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
  mcp serve --transport http --port 8000

# Then connect claude-cli
claude-cli --mcp http://localhost:8000

Vom lokalen Pfad ausführen (Entwicklung):

# Run the server in HTTP mode first
uvx --from /path/to/your/project/mcp mcp serve --transport http --port 8000

# Then connect claude-cli
claude-cli --mcp http://localhost:8000

Entwicklung

Ausführliche Entwicklungsanweisungen finden Sie unter CLAUDE.md .

Paketstruktur

src/mcp/ : Haupt-MCP-Paket
- transport/ : Transportimplementierungen (HTTP, stdio)
- mock/ : Mock-Datenanbieter für die Entwicklung
- tools.py : Werkzeugdefinitionen
- handlers.py : Anforderungshandler
- main.py : CLI-Einstiegspunkte
- adapters/ : Adapterimplementierungen
- core/ : Kernfunktionalität
tests/ : Testsuite

Testen

# Ensure dev dependencies are installed: pdm install -G dev
pdm run test

Lintierung und Formatierung

Verwendet ruff , black , isort , mypy über pdm-Skripte.

# Run all linters/formatters
pdm run lint

# Run only ruff
pdm run linter

Lizenz

Proprietär - Jentic

Jentic

Integrations

Jentic MCP Plugin

Warum Jentic MCP verwenden?

API-Tools

Erste Schritte

Holen Sie sich Ihre Jentic UUID

Verwendung des MCP-Tools

Umgebungsvariablen

Installation

Ausführen des MCP-Servers

Standardmodus (Stdio)

HTTP-Modus

Ausführen von einem Remote-Git-Repository

Weitere Optionen

Protokollierung

Mock-Modus

Umgebungsvariablen

Verwendung mit Claude

Entwicklung

Paketstruktur

Testen

Lintierung und Formatierung

Lizenz

Tools

Related Resources

Related MCP Servers

MCP Neo4j Server

confluence-mcp

Jira MCP Server

Jotdown

New MCP Servers