Skip to main content
Glama
deenesjakoruzh
PortalFnd

PortalMCP

by PortalFnd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

🌐 PortalMCP

イーサリアムへのユニバーサルAIゲートウェイ

1つのサーバー。すべてのAI。チェーン全体を操作。

Claude、ChatGPT、Gemini、Cursor、Windsurf、Cline、カスタムエージェントなど、あらゆるModel-Context-Protocol（MCP）クライアントを自然言語でイーサリアムに接続します。残高確認、トークンのスワップ、NFTのミント、スマートコントラクトの生成とデプロイが可能です。

MCP SDK Ethers TypeScript License Release

クイックスタート · セットアップ · ツール · ロードマップ · 変更履歴

✨ PortalMCPを選ぶ理由

ほとんどのAIとブロックチェーンの統合は、特定のLLMやクライアントに縛られます。PortalMCPは仕様に準拠したMCPサーバーであり、ローカルまたはVPS上で実行することで、MCP対応のあらゆるクライアントを強化します。

🔐 非カストディアル — 秘密鍵は決してマシンから離れません 🛰️ ライブチェーンコンテキスト — ETH残高、取引レシート、トークンメタデータをチャットに直接ストリーミングします 🛡️ 安全性重視 — すべてのツールが読み取り/破壊的/冪等性のヒントを宣言するため、クライアントはブロードキャスト前に確認できます 🧩 ユニバーサル — stdioとHTTPの両方で動作し、すべてのMCPクライアントと連携します

Related MCP server: Hexiaoyi MCP

🧭 対応クライアント

クライアント

トランスポート

備考

🟣 Claude Desktop (macOS/Windows)

stdio

下記の設定を参照

🌐 Claude.ai web + mobile

HTTP

カスタムコネクタとして追加 (Pro/Team/Enterprise)

💻 Claude Code / CLI

いずれか

🧠 Cursor · Windsurf · Cline · Continue · Zed AI

stdio

ネイティブMCP

💬 ChatGPT (Team/Enterprise)

HTTP

MCPコネクタ

🛠️ ChatGPT Custom GPTs

REST

バンドルされたopenapi.jsonを使用

✴️ Google Gemini / Vertex Agents

HTTP

MCPコネクタ

🐍 LangChain · LlamaIndex · OpenAI Agents SDK

いずれか

MCPアダプター経由

🤖 任意のHTTPエージェント

HTTP

/mcp上のプレーンJSON-RPC + SSE

🎯 できること

⚡ 一般

ツール

アクション

eth_get_balance

アドレスまたはデフォルトウォレットのETH残高

eth_call_contract

任意のコントラクトとABIに対する読み取り専用呼び出し

eth_send_transaction

未署名の汎用トランザクションの準備

📜 スマートコントラクト

ツール

アクション

eth_generate_contract

自然言語からClaudeが作成したSolidityコード

eth_compile_contract

solcコンパイル → バイトコード + ABI

eth_deploy_contract

外部ウォレット署名用のデプロイトランザクション準備

eth_deploy_contract_with_signer

DEPLOYER_PRIVATE_KEYを使用して直接デプロイ

🪙 ERC-20トークン

ツール

アクション

eth_create_token

ERC-20 Solidityの生成

eth_get_token_balance

任意の保有者のERC-20残高

eth_transfer_token

署名済み転送または未署名トランザクションの準備

🖼️ ERC-721 NFT

ツール

アクション

eth_create_nft_collection

ERC-721 Solidityの生成

eth_mint_nft

mint / safeMint / mintWithURI の準備

eth_get_nft_owner

ownerOf() 検索

🏦 DeFi

ツール

アクション

eth_create_staking_contract

ステーキング用Solidityの生成

eth_stake_tokens

承認 + ステーキングトランザクションの準備

eth_swap_tokens

ユニバーサルUniswap V3スワップ (任意のERC-20ペア)

eth_swap_eth_to_usdt

上記の便利なエイリアス

URI

戻り値

eth://wallet

設定された署名者アドレス、ネットワーク、ETH残高

eth://balance/{address}

任意アドレスのライブETH残高

eth://tx/{hash}

トランザクション + レシート (ステータス、ガス、ブロック、ログ、エクスプローラーURL)

eth://token/{address}

ERC-20メタデータ (名前、シンボル、小数点、総供給量)

  • /swap_tokens — ガイド付きトークンスワップフロー

  • /deploy_erc20 — 生成 → コンパイル → デプロイのエンドツーエンド実行

🚀 クイックスタート

git clone https://github.com/PortalFnd/PortalMCP.git
cd PortalMCP/portalmcp
npm install
cp .env.example .env
# fill in .env — ANTHROPIC_API_KEY, DEPLOYER_PRIVATE_KEY,
# and ETHEREUM_RPC_URL (or a real ALCHEMY_API_KEY)
npm run build
npm run smoke          # ✓ 17 tools / 1 resource / 3 templates / 2 prompts
npm start              # stdio (Claude Desktop, Cursor, …)
# or
npm run start:http     # Streamable HTTP on http://0.0.0.0:3333/mcp

🔌 クライアントセットアップ

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) を編集します：

{
  "mcpServers": {
    "portalmcp": {
      "command": "node",
      "args": ["/absolute/path/to/PortalMCP/portalmcp/dist/index.js"],
      "env": {
        "ETHEREUM_NETWORK": "mainnet",
        "ETHEREUM_RPC_URL": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
        "DEPLOYER_PRIVATE_KEY": "0x...",
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

Claude Desktopを再起動します。17個のツール、eth://リソース、および2つのスラッシュコマンドが自動的に表示されます。

  1. パブリックHTTPS URL（Caddy / Cloudflare Tunnel / Nginx）を使用してHTTPサーバーをホストします。

  2. MCP_HTTP_TOKEN=<長いランダム文字列>を設定し、自分だけが呼び出せるようにします。

  3. Claude.ai → 設定 → コネクタ → カスタムコネクタを追加:

    • URL: https://your-host.example.com/mcp

    • 認証: Authorization: Bearer <MCP_HTTP_TOKEN>

  4. Webおよびモバイルアプリの両方で動作します。

すべてMCPをネイティブにサポートしています。MCP設定に以下を指すエントリを追加してください：

node /absolute/path/to/PortalMCP/portalmcp/dist/index.js

(Claude Desktopと同じstdioコマンドです。)

推奨 — MCPコネクタ (ChatGPT Team/Enterprise, Gemini/Vertex Agents): https://your-host/mcp を指定し、必要に応じてBearerトークンを使用します。

レガシーREST (ChatGPT Custom GPT Actionsまたは任意のHTTPエージェント):

npm run start:api
# OpenAPI spec: http://localhost:3001/openapi.json

💬 会話例

ゼロからトークンをデプロイ

「初期供給量1,000,000のPortalToken (PRTL) というERC-20をデプロイして。」

→ eth_generate_contract → コードを表示 → eth_compile_contract → eth_deploy_contract_with_signer → コントラクトアドレスとEtherscanリンクを返します。

ユニバーサルスワップ

「0.01 ETHをUSDCにスワップして。」

→ eth_swap_tokens { tokenIn:"ETH", tokenOut:"USDC", amount:"0.01" } — (必要な場合)承認を行い、Uniswap V3経由で実行します。

ライブオンチェーンコンテキスト

「vitalik.ethの残高は？」

→ クライアントが eth://balance/0xd8dA… リソースを会話に直接添付します。

⚙️ 設定

すべて環境変数（.envファイルまたはホスト環境）経由で行います。完全なリストは .env.example にあります。

変数

必須

目的

ETHEREUM_NETWORK

–

mainnet, sepolia, arbitrum, optimism, base, polygon など (デフォルト mainnet)

ETHEREUM_RPC_URL

⭐

完全なJSON-RPC URL — Infura/Alchemyキー設定を上書き

ALCHEMY_API_KEY

代替

キーのみ — PortalMCPが最新の g.alchemy.com URLを構築

INFURA_API_KEY

代替

InfuraプロジェクトID

DEPLOYER_PRIVATE_KEY

書き込み

0xで始まる16進数 — 署名者が必要なツールを有効化

ANTHROPIC_API_KEY

生成

eth_generate_contract 用

ANTHROPIC_MODEL

–

デフォルトの claude-sonnet-4-5-20250929 を上書き

MCP_HTTP_PORT

–

デフォルト 3333

MCP_HTTP_HOST

–

デフォルト 0.0.0.0

MCP_HTTP_TOKEN

🛡️

HTTPトランスポート用のBearerトークン

MCP_HTTP_CORS_ORIGIN

–

デフォルト *

💡 プレースホルダー検出 — your_, changeme, xxx, placeholder, <…> で始まる環境変数の値は未設定として扱われます。誤設定を未然に防ぎます。

🌍 対応ネットワーク

🛡️ セキュリティ

  • 🚫 .envをコミットしない — すでに.gitignoreに含まれています。

  • 🔑 DEPLOYER_PRIVATE_KEYは危険です。 失っても良い資金のみを入れた専用のエージェントウォレットを使用してください。

  • 🛰️ HTTPをローカル以外に公開する場合は必ずMCP_HTTP_TOKENを設定し、TLS (Caddy/Cloudflare) を前段に置いてください。

  • 🧪 テストネット優先 — 開発には sepolia を使用し、フローを確認した後にのみメインネットを使用してください。

  • 🏷️ ツールのアノテーションにより、破壊的なトランザクションの前にクライアントが確認を求めます。自動承認はしないでください。

  • 👀 生成されたSolidityを確認する — eth_generate_contract は出発点であり、監査済みではありません。

🧑💻 開発

npm install
npm run dev          # stdio, ts-node hot-reload
npm run dev:http     # HTTP, ts-node
npm run build        # tsc → dist/
npm run smoke        # assert MCP surface is registered
npm test             # Jest

スクリプト

目的

npm start

stdio MCPサーバー (本番)

npm run start:http

ストリーミング可能なHTTP MCPサーバー (本番)

npm run start:api

ChatGPT Actions / HTTPクライアント用レガシーREST

npm run smoke

登録スモークテスト — CIに最適

リポジトリ構成

portalmcp/
├── src/
│   ├── index.ts              # stdio entrypoint
│   ├── mcp-http.ts           # Streamable HTTP entrypoint
│   ├── server-factory.ts     # createPortalServer() — shared wiring
│   ├── smoke-test.ts         # CI registration check
│   ├── tools/                # general · contracts · defi · tokens · nfts
│   ├── blockchain/           # EthereumService · CompilerService
│   ├── claude/               # ContractGenerator (Anthropic SDK)
│   ├── contracts/            # Solidity templates
│   └── adapters/             # Legacy REST / LangChain / OpenAI adapters
├── dist/                     # tsc output
├── .env.example
└── package.json

🏗️ アーキテクチャ

          stdio                                 Streamable HTTP (SSE)
┌─────────────────────┐                  ┌─────────────────────────────┐
│  Claude Desktop     │                  │   Claude.ai web + mobile    │
│  Cursor · Windsurf  │                  │   ChatGPT · Gemini          │
│  Cline · Continue   │                  │   Custom agents             │
└─────────┬───────────┘                  └──────────────┬──────────────┘
          │                                             │
          │        ┌──────────────────────┐             │
          └───────▶│   PortalMCP server   │◀────────────┘
                   │  (server-factory.ts) │
                   └──────────┬───────────┘
                              │
       ┌──────────────────────┼──────────────────────┐
       ▼                      ▼                      ▼
  EthereumService         Uniswap V3             Anthropic
  (ethers v6 +        (eth_swap_tokens)      (eth_generate_contract)
   Alchemy/Infura/
   custom RPC)

🗺️ ロードマップのハイライト

完全な計画は ROADMAP.md を参照してください。

🤝 貢献

プルリクエストを歓迎します！優先分野：outputSchemaの網羅、追加ツール、Dockerパッケージング、Pythonクライアント、テストカバレッジ。重要な変更を行う前に、まずIssueを作成してください。

⭐ このリポジトリにスターを付ける · 🐛 Issueを報告する · 📜 MITライセンス

Built with 💜 by the Portal Foundation

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Hexiaoyi MCP

    dddd-community
    A
    license
    Not graded
    quality
    D
    maintenance
    A powerful toolkit that enables seamless interaction with EVM-compatible networks through natural language processing and AI assistance, allowing users to manage wallets, launch tokens, and interact with blockchain networks.
    7 npm
    MIT

  • Universal Crypto MCP

    nirholas
    A
    license
    C
    quality
    B
    maintenance
    Enables AI agents to interact with any EVM-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tracking across networks like Ethereum, BSC, Polygon, Arbitrum, and more.
    100
    31 npm
    42
    -

Appeared in Searches