ジェンティック

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

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Jentic プラグインを自動的にインストールするには:

npx -y @smithery/cli install @jentic/jentic-tools --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）

--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

Jentic

Jentic MCPプラグイン

Jentic MCP を使用する理由

APIツール

はじめる

Jentic UUIDを取得する

MCPツールの使用

環境変数

インストール

Smithery経由でインストール

手動インストール

MCPサーバーの実行

デフォルトモード（Stdio）

HTTPモード

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

その他のオプション

ログ記録

モックモード

環境変数

クロードと一緒に使う

発達

パッケージ構造

テスト

リンティングとフォーマット

ライセンス

Tools

Related Resources

Related MCP Servers

mcp-tenki

Jotdown

Trivyofficial

Cyclops

New MCP Servers

MCP directory API