Jentic

Jentic MCP プラグイン

Jentic MCP を使う理由

Jentic MCP を活用すると、API 固有のコードを記述したり保守したりすることなく、外部 API やワークフローをすばやく見つけて統合できます。MCP プロトコルと Jentic のエージェント型ランタイムを利用することで、開発者は次のことができます。

• ベンダーや実装ではなく、機能に基づいて API やワークフローを検索できます。
• 特定の API の詳細に依存しない統合用コードサンプルをすぐに生成できます。
• 標準化された宣言的な統合を利用して、定型コードを避け、保守の負担を軽減できます。
• Jentic MCP が API 連携の複雑さを処理する間、機能の開発に集中できます。

API ツール

Jentic MCP プラグインは、次のツールを提供します。

1. search_apis：Jentic ディレクトリから、特定の機能要件に合う API を検索します
2. load_execution_info：Jentic ディレクトリから、API と操作の詳細な仕様を取得します。これには、mcpServers.jentic.env の設定で指定が必要な認証情報が含まれます。
3. execute：特定の API またはワークフローの操作を実行します。

はじめに

推奨される方法は、uvx を使って GitHub リポジトリからサーバーを直接実行することです。
まず、次のコマンドで uv をインストールしてください。

brew install uv or pip install uv

エージェント API キー

https://app.jentic.com/sign-in でエージェントを作成し、API キーをコピーします。

export JENTIC_AGENT_API_KEY=<your-agent-api-key>

以下に示すように、MCP クライアントの設定でキーを設定します。

設定ファイルの場所は、使用するクライアントと OS によって異なります。一般的な例をいくつか示します。

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

その他のクライアントについては、MCP サーバーの追加方法をクライアントのドキュメントで確認してください。

{
    "mcpServers": {
        "jentic": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/jentic/jentic-sdks.git@main#subdirectory=mcp",
                "mcp"
            ],
            "env": {
                "JENTIC_AGENT_API_KEY": "<your-agent-api-key>"
            }
        }
    }
}

注： 設定ファイルを保存した後、変更を反映するためにクライアントアプリケーション（Windsurf、Claude Desktop）の再起動が必要になる場合があります。

MCP ツールの使用

MCP サーバーが実行されたら、LLM エージェントで MCP ツールを簡単に使用して、API やワークフローを見つけて実行できます。

1. search_apis：Jentic ディレクトリから、特定の機能要件に合う API を検索します
2. load_execution_info：Jentic ディレクトリから、API と操作の詳細な仕様を取得します。これには、mcpServers.jentic.env の設定で指定が必要な認証情報が含まれます。
3. execute：特定の API またはワークフローの操作を実行します。

環境変数

認証が必要な API を使用する場合、load_execution_info ツールが必要な環境変数を説明します。Windsurf ではコマンドラインから環境変数を設定できますが、Claude Desktop など一部のクライアントでは、MCP 設定に追加する必要があります。

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

別の方法（開発用にローカルパスを使用）：

MCP プラグインをローカルで開発している場合に使用してください。/path/to/your/project/mcp をプロジェクトディレクトリの絶対パスに置き換えます。

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

任意： mcp_config.json ファイルに JENTIC_API_URL 環境変数を追加すると、特定の Jentic API を指定できます（どちらの方法でも使用できます）。

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

設定したら、Windsurf を再起動すると、Jentic MCP ツールを使用できるようになります。

ローカルで実行中の MCP サーバーが生成するログは、次のコマンドで追跡できます。

tail /path/to/mcp/jentic_ark2_mcp.log

インストール

Smithery 経由でのインストール

Smithery 経由で Jentic プラグインを Claude Desktop に自動インストールするには、次のコマンドを実行します。

npx -y @smithery/cli install @jentic/jentic-sdks --client claude

手動インストール

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）

uvx を使用して MCP プラグインを直接実行します。--from と 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-sdks.git@main#subdirectory=mcp \
  mcp

これにより、mcp スクリプトのコールバックで定義されたデフォルトの serve --transport stdio コマンドが自動的に使用されます。

HTTP モード

MCP サーバーは、次の 2 種類の HTTP トランスポートモードをサポートしています。

• 標準 HTTP：従来のリクエスト・レスポンス方式の HTTP モード
• ストリーミング可能な HTTP：ストリーミングに対応し、MCP Inspector と互換性のある HTTP モード

標準 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-sdks.git@main#subdirectory=mcp \
  mcp serve --transport http --port 8080

ストリーミング可能な HTTP モード

ストリーミング可能な HTTP モード（MCP Inspector と互換）でサーバーを実行する場合：

ローカルパスから実行（開発用）：

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

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

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

リモートリポジトリから実行（推奨）：

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

リモート Git リポジトリからの実行

uvx --from を使用すると、Git リポジトリの URL からローカルにクローンせずに MCP サーバーを直接実行することもできます。

# Example from a specific branch and subdirectory
uvx --from \
  git+https://github.com/jentic/jentic-sdks.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-sdks.git@main#subdirectory=mcp \
  --log-level DEBUG --mock

リモートソースから HTTP モードで実行する場合：

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

リモートソースからストリーミング可能な HTTP モードで実行する場合：

uvx --from \
  git+https://github.com/jentic/jentic-sdks.git@main#subdirectory=mcp \
  serve --transport streamable-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
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-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
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-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

# Mock mode with streamable HTTP
uvx --from /path/to/your/project/mcp mcp serve --transport streamable-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

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

Claude での使用

この MCP プラグインは、MCP 仕様をサポートする Claude やその他の LLM で使用できます。

リモートリポジトリから実行（推奨）：

# Run the server in HTTP mode first
uvx --from \
  git+https://github.com/jentic/jentic-sdks.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 のメインパッケージ
  • 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