JPYC Agent MCP

JPYC Agent MCP

JPYC Agent MCP は、パブリック MCP エンドポイントとしても、Codex プラグインバンドルとしても使用できます。 このリポジトリでは、Codex が直接検出できるよう、リポジトリのルートをプラグインのルートとして使用します。

対応機能

• Polygon エージェントウォレットの作成と検索
• ウォレット残高の確認
• JPYC 送金の見積もりと実行フロー
• コントラクトの読み取り呼び出し
• コントラクト書き込みの見積もりと実行フロー
• 送金とコントラクト呼び出しのステータス追跡

プラグインの構成

Codex は以下のファイルを通じて、リポジトリのルートからプラグインを検出します。

• .codex-plugin/plugin.json
• .mcp.json
• skills/jpyc-agent-mcp/SKILL.md
• skills/jpyc-agent-mcp/agents/openai.yaml
• config/default.json

パブリックエンドポイント

• MCP エンドポイント：https://jpyc-info.com/api/jpyc-agent-mcp
• OAuth 発行者：https://jpyc-info.com/api/jpyc-agent-oauth
• リソースメタデータ：https://jpyc-info.com/.well-known/oauth-protected-resource
• 認可サーバーメタデータ：https://jpyc-info.com/.well-known/oauth-authorization-server
• OpenID 設定：https://jpyc-info.com/.well-known/openid-configuration
• ユーザーのサインインページ：https://jpyc-info.com/mcp/connect
• MCP Registry 認証ファイル：https://jpyc-info.com/.well-known/mcp-registry-auth

エンドポイントは OAuth で保護されています。プライベートウォレット操作を実行する前に、ユーザーはログインして同意を与える必要があります。 MCP エンドポイントをブラウザーで直接開くと、https://jpyc-info.com/mcp/connect にリダイレクトされます。 MCP クライアントが 401 unauthorized を受信した場合は、WWW-Authenticate と上記のリソースメタデータを参照して OAuth フローを検出する必要があります。 ChatGPT/Codex で完全な認可 URL が自動的に表示されない場合は、ユーザー向けの標準的な代替手段として、ブラウザーで https://jpyc-info.com/mcp/connect を開いてください。低レベルの手動認証には /api/jpyc-agent-oauth/start もデバッグ用に引き続き利用できますが、ドキュメントで推奨する方法ではありません。低レベルのフローを使用するクライアントは、返された auth_session_secret を秘密に保ち、/api/jpyc-agent-oauth/auth-session のポーリング時に提示する必要があります。

OAuth の仕様と正確な URL については、docs/auth.md と config/oauth.json を参照してください。

Claude Code

Claude Code は streamable-http MCP サーバーをネイティブではサポートしていません。 streamable-http + OAuth を stdio にブリッジするには、mcp-remote を使用してください。

クイックスタート

以下をプロジェクトの .mcp.json または ~/.claude/settings.json に追加してください。

{
  "mcpServers": {
    "jpyc-agent-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://jpyc-info.com/api/jpyc-agent-mcp"
      ]
    }
  }
}

初回接続時、mcp-remote は OAuth の同意を得るためにブラウザーを開きます。 認証後、すべてのツールをすぐに利用できます。

クライアントのトークン永続化

このリポジトリでは、OAuth で保護された MCP エンドポイントと、Codex が検出するために必要なプラグインのメタデータを定義しています。Codex、ChatGPT、その他の MCP クライアントに代わって、クライアント側の認証情報ストレージを実装するものではありません。

クライアントに期待される動作は次のとおりです。

1. JPYC Agent OAuth 発行者に対して OAuth フローを開始する
2. 発行されたベアラートークンまたは同等のセッション認証情報を受け取る
3. その認証情報をクライアントのローカルの安全なストレージに保存する
4. 以降の MCP 呼び出しで https://jpyc-info.com/api/jpyc-agent-mcp に対して再利用する
5. auth_status で復元したセッションを検証する

クライアントがブラウザーでのログインを完了できても、発行された認証情報をローカルに保存して再利用できない場合、ユーザーの視点では MCP 統合は不完全です。その場合、修正すべきなのはこのリポジトリのサーバー側 OAuth プロトコルではなく、MCP クライアントの実装です。

ローカルでの運用ワークフロー向けに、このリポジトリには、発行されたリフレッシュトークンを DPAPI で保存し、以降のセッションで再利用するヘルパーが含まれています。

• docs/local-token-cache.md
• scripts/jpyc_oauth_cache.py（Python、Windows）
• scripts/jpyc_oauth_cache.ps1（PowerShell、Windows）

MCP レジストリ

このリポジトリには、ドメインベースの名前空間 com.jpyc-info/jpyc-agent-mcp を使用して、リモートサーバーを公開 MCP レジストリに登録するための server.json が含まれています。

HTTP ベースのドメイン検証を行うには、正確なテキスト値 v=MCPv1; k=...; p=... を https://jpyc-info.com/.well-known/mcp-registry-auth でホストします。jpyc-info のデプロイでは、このエンドポイントは MCP_REGISTRY_AUTH 環境変数から提供されます。

主なツール

• auth_status
• list_agent_wallets
• get_agent_wallet
• create_agent_wallet
• get_agent_wallet_balance
• quote_transfer
• transfer_jpyc
• list_transactions
• get_transfer_status
• read_contract
• quote_contract_write
• execute_contract_write
• list_contract_call_history
• get_contract_call_status

リクエストとレスポンスの詳細な例は、docs/tools.md にあります。

推奨されるフロー

1. auth_status を確認する
2. list_agent_wallets でウォレットを確認する
3. 必要な場合に限り、create_agent_wallet でウォレットを作成する
4. 送金の前に残高を確認する
5. 送金とコントラクトへの書き込みには、見積もりを先に行う方式を使用する

送金フロー：

1. quote_transfer
2. transfer_jpyc

コントラクトへの書き込みフロー：

1. quote_contract_write
2. execute_contract_write

注意事項

• このリポジトリにシークレットは含まれていません。
• このリポジトリに秘密鍵や署名者の情報は含まれていません。
• 同梱のスキルは、Codex が JPYC Agent MCP ツールの範囲内で動作するようにすることを目的としています。
• 詳細については、docs/auth.md、config/oauth.json、docs/openai-and-mcp.md を参照してください。