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.
Related MCP server: Jotdown
API-Tools
Das Jentic MCP Plugin bietet die folgenden Tools:
search_apis: Suche nach APIs im Jentic-Verzeichnis, die bestimmten Funktionsanforderungen entsprechenload_execution_info: Ruft detaillierte Spezifikationen für APIs und Operationen aus dem Jentic-Verzeichnis ab. Dies beinhaltet Authentifizierungsinformationen, die Sie möglicherweise in Ihrerexecute: 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.jsonClaude Desktop :
~/Library/Application Support/Claude/claude_desktop_config.jsonClaude-Code :
~/.claude.jsonCursor :
~/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 entsprechenload_execution_info: Ruft detaillierte Spezifikationen für APIs und Operationen aus dem Jentic-Verzeichnis ab. Dies beinhaltet Authentifizierungsinformationen, die Sie möglicherweise in Ihrerexecute: 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.logInstallation
Installation über Smithery
So installieren Sie das Jentic-Plugin für Claude Desktop automatisch über Smithery :
npx -y @smithery/cli install @jentic/jentic-tools --client claudeManuelle 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 devAusfü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 mit --from und dem mcp -Skript an:
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 . mcpAus dem Remote-Repository (für die allgemeine Verwendung empfohlen):
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
mcpDabei 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 8080Aus dem Remote-Repository (empfohlen):
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
mcp serve --transport http --port 8080Ausfü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.tomlDieser 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 --mockSo 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 8080Weitere 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.logMock-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 --mockUmgebungsvariablen
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 .envVerwendung 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:8000Vom 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:8000Entwicklung
Ausführliche Entwicklungsanweisungen finden Sie unter CLAUDE.md .
Paketstruktur
src/mcp/: Haupt-MCP-Pakettransport/: Transportimplementierungen (HTTP, stdio)mock/: Mock-Datenanbieter für die Entwicklungtools.py: Werkzeugdefinitionenhandlers.py: Anforderungshandlermain.py: CLI-Einstiegspunkteadapters/: Adapterimplementierungencore/: Kernfunktionalität
tests/: Testsuite
Testen
# Ensure dev dependencies are installed: pdm install -G dev
pdm run testLintierung und Formatierung
Verwendet ruff , black , isort , mypy über pdm-Skripte.
# Run all linters/formatters
pdm run lint
# Run only ruff
pdm run linterLizenz
Proprietär - Jentic
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.