Jentic MCPプラグイン
Jentic MCP を使用する理由
Jentic MCPは、開発者がAPI固有のコードを記述・保守することなく、外部APIやワークフローを迅速に発見・統合することを可能にします。MCPプロトコルとJenticのエージェントランタイムを活用することで、開発者は以下のことが可能になります。
- ベンダーや実装ではなく、機能別に API とワークフローを検索します。
- 特定の API の詳細に依存しない統合コード サンプルを即座に生成します。
- 標準化された宣言型の統合を利用することで、定型句を回避し、メンテナンスを軽減します。
- Jentic MCP が API 相互作用の複雑さを処理するので、機能の構築に集中できます。
APIツール
Jentic MCP プラグインは次のツールを提供します。
search_apis : 特定の機能ニーズに一致する Jentic ディレクトリ内の API を検索しますload_execution_info : JenticディレクトリからAPIと操作の詳細な仕様を取得します。これには、 mcpServers.jentic.env設定で指定する必要がある可能性のある認証情報が含まれます。execute : 特定の API またはワークフロー操作を実行します。
はじめる
推奨される方法は、 uvxを使用して GitHub リポジトリから直接サーバーを実行することです。まず、以下のコマンドでuvをインストールする必要があります。
brew install uvまたはpip install uv
Jentic UUIDを取得する
Jentic SDKを使用するには、まずJentic UUIDを取得する必要があります。最も簡単な方法はJentic CLIを使用することです。オプションでメールアドレスを入力すると、レート制限の引き上げや新機能への早期アクセスが可能になります。
pip install jentic
jentic register --email '<your_email>'
これにより、UUID とそれを環境に設定するためのエクスポート コマンドが出力されます。
export JENTIC_UUID=<your-jentic-uuid>
以下に示すように、MCP クライアント構成で Jentic UUID を設定します。
設定ファイルの場所は、使用しているクライアントとOSによって異なります。一般的な例を以下に示します。
- ウィンドサーフィン:
~/.codeium/windsurf/mcp_config.json - Claude デスクトップ:
~/Library/Application Support/Claude/claude_desktop_config.json - クロードコード:
~/.claude.json - カーソル:
~/cursor/.mcp.json
その他のクライアントの場合、MCP サーバーを追加する方法については、クライアントのドキュメントを確認してください。
{
"mcpServers": {
"jentic": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
"mcp"
],
"env": {
"JENTIC_UUID": "<your-jentic-uuid>"
}
}
}
}
**注意:**構成ファイルを保存した後、変更を有効にするにはクライアント アプリケーション (Windsurf、Claude Desktop) を再起動する必要がある場合があります。
MCPツールの使用
MCP サーバーが実行される場合は、LLM エージェントの MCP ツールを使用して、API とワークフローを簡単に検出して実行できます。
search_apis : 特定の機能ニーズに一致する Jentic ディレクトリ内の API を検索しますload_execution_info : JenticディレクトリからAPIと操作の詳細な仕様を取得します。これには、 mcpServers.jentic.env設定で指定する必要がある可能性のある認証情報が含まれます。execute : 特定の API またはワークフロー操作を実行します。
環境変数
認証が必要なAPIを使用する場合、 load_execution_infoツールは必要な環境変数を表示します。Windsurfではコマンドラインから環境変数を設定できますが、Claude Desktopなどの一部のクライアントでは、MCP設定に追加する必要があります。
{
"mcpServers": {
"jentic": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp",
"mcp"
],
"env": {
"DISCORD_BOTTOKEN=": "YOUR BOT TOKEN"
}
}
}
}
代替案（開発にローカルパスを使用する）:
MCPプラグインをローカルで開発している場合は、こちらを使用してください。/path/to/your/project/mcp /path/to/your/project/mcpプロジェクトディレクトリへの絶対パスに置き換えてください。
{
"mcpServers": {
"jentic": {
"command": "uvx",
"args": [
"--from",
"/path/to/your/project/mcp",
"mcp"
]
}
}
}
*オプション:*特定の Jentic API を指すように、 JENTIC_API_URL環境変数をmcp_config.jsonファイルに追加します (両方の方法で機能します)。
{
"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/"
}
}
}
}
設定が完了したら、Windsurf を再起動すると、Jentic MCP ツールが使用できるようになります。
次のコマンドを実行すると、ローカルで実行されている MCP サーバーによって生成されたログを tail できます。
tail /path/to/mcp/jentic_ark2_mcp.log
インストール
pdmがインストールされていることを確認してください ( pipx install pdm )。
開発用にパッケージとその依存関係をインストールするには:
# From the project root directory (e.g., /Users/kc/c/sdk/mcp)
pdm install -G dev
MCPサーバーの実行
Jentic MCP プラグインは、環境のセットアップと実行を処理するuvxを使用して実行されるように設計されています。
デフォルトモード（Stdio）
--fromとmcpスクリプトを使用してプロジェクト ディレクトリをソースとして指定し、 uvxを使用して MCP プラグインを直接実行します。
ローカルパス（開発）から:
# 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
リモート リポジトリから (一般的な使用に推奨):
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
mcp
これにより、 mcpスクリプトのコールバックで定義されているデフォルトのserve --transport stdioコマンドが自動的に使用されます。
HTTPモード
サーバーを HTTP モードで実行するには (例: claude-cliでテストする場合):
ローカルパス（開発）から:
# 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
リモートリポジトリから（推奨）:
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
mcp serve --transport http --port 8080
リモート Git リポジトリから実行
uvx --fromを使用して、ローカルにクローンせずに Git リポジトリ URL から直接 MCP サーバーを実行することもできます。
# 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
このコマンドは、指定されたバージョンを取得し、その依存関係を一時環境にインストールし、デフォルトのコマンド ( serve --transport stdio ) を実行します。
URL フラグメントの後に--log-level DEBUGや--mockなどの他の引数を追加することもできます。
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
--log-level DEBUG --mock
リモート ソースから HTTP モードで実行するには:
uvx --from \
git+https://github.com/jentic/jentic-tools.git@main#subdirectory=mcp \
serve --transport http --port 8080
その他のオプション
ログ記録
# 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
モックモード
実際の Jentic API Knowledge Hub に接続せずに開発用のモック モードを有効にします。
# 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
環境変数
.envファイルを使用して環境変数を提供します。
# 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
クロードと一緒に使う
MCP プラグインは、Claude または MCP 仕様をサポートする他の LLM で使用できます。
リモート リポジトリから実行 (推奨):
# 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
ローカルパスから実行 (開発):
# 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
発達
詳細な開発手順については、 CLAUDE.md を参照してください。
パッケージ構造
src/mcp/ : メインMCPパッケージtransport/ : トランスポート実装 (HTTP、stdio)mock/ : 開発用のモックデータプロバイダーtools.py : ツール定義handlers.py : リクエストハンドラーmain.py : CLI エントリポイントadapters/ : アダプタの実装core/ : コア機能
tests/ : テストスイート
テスト
# Ensure dev dependencies are installed: pdm install -G dev
pdm run test
リンティングとフォーマット
pdm スクリプト経由でruff 、 black 、 isort 、 mypy使用します。
# Run all linters/formatters
pdm run lint
# Run only ruff
pdm run linter
ライセンス
独自仕様 - Jentic