Alchemy MCP サーバー

AI エージェントが Alchemy のブロックチェーン API と構造化された方法で対話できるようにする Model Context Protocol (MCP) サーバーです。これにより、エージェントはコードを書くことなく、ブロックチェーンデータを直接クエリできるようになります。

リモート MCP サーバー (推奨)

最も早く開始する方法は、ホストされているリモートサーバー https://mcp.alchemy.com/mcp に接続することです。OAuth を介して認証されるため、プロンプトが表示されたら Alchemy アカウントでサインインするだけです。API キーやローカルインストールは不要です。

完全なドキュメント: alchemy.com/docs/alchemy-mcp-server

注: mcp.alchemy.com でホストされているサーバーとこのオープンソースリポジトリは個別に管理されており、同期されていない場合があります。

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

その他の MCP 対応クライアントの場合は、Streamable HTTP トランスポートを使用して https://mcp.alchemy.com/mcp を指定してください。

Related MCP server: Substrate MCP Server

ローカル STDIO サーバー

この MCP サーバーは、AI エージェントと Alchemy のブロックチェーン API との間のブリッジを作成し、エージェントが以下を実行できるようにします：

• トークン価格と価格履歴のクエリ（柔軟な期間クエリを含む）

• NFT 所有権情報とコントラクトデータの取得

• 複数のネットワークにわたるトランザクション履歴の表示

• 複数のブロックチェーンネットワークにわたるトークン残高の確認

• フィルタリング機能付きの詳細な資産転送の取得

• スマートコントラクトアカウントを介したトランザクションの送信 (設定済みのウォレットエージェントサーバーが必要)

• DEX プロトコルを介したトークンスワップの実行 (設定済みのウォレットエージェントサーバーが必要)

• その他多数！

クイックセットアップ

MCP サーバーを素早くセットアップするには、MCP 設定ファイル（通常は Claude Desktop または Cursor の設定）で以下の設定を使用します：

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": ["-y", "@alchemy/mcp-server"],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

この設定により、リポジトリを手動でクローンすることなくサーバーを使用できます。

環境変数

MCP サーバーには以下の環境変数が必要です：

• ALCHEMY_API_KEY - Alchemy API キー（すべてのブロックチェーンデータクエリに必須）

トランザクションおよびスワップ機能を使用する場合は、以下も設定する必要があります：

• AGENT_WALLET_SERVER - スマートコントラクトアカウント操作を処理する、設定済みのウォレットエージェントサーバーの URL

⚠️ 重要: sendTransaction および swap メソッドは、適切に設定されたウォレットエージェントサーバーなしでは機能しません。これらのメソッドには、トランザクションの署名とブロードキャストを処理するための外部ウォレットインフラストラクチャが必要です。

利用可能なメソッド

AI エージェントに対して、以下のメソッドを使用するように指示できます：

トークン価格メソッド

1. fetchTokenPriceBySymbol

   • シンボルでトークンの現在価格データを取得

   • 例: "ETH と BTC の現在の価格は？"

2. fetchTokenPriceByAddress

   • コントラクトアドレスでトークンの現在価格データを取得

   • 例: "Ethereum メインネット上のアドレス 0x1234...5678 のトークン価格は？"

3. fetchTokenPriceHistoryBySymbol

   • 特定の日付範囲でトークンの過去の価格データを取得

   • 例: "2023年1月1日から2月1日までの BTC の価格履歴を日次間隔で表示して"

4. fetchTokenPriceHistoryByTimeFrame

   • 柔軟な期間や自然言語を使用して過去の価格データを取得

   • 例: "先週の ETH 価格を表示して" または "過去30日間の BTC 価格を取得して"

マルチチェーン・トークンメソッド

5. fetchTokensOwnedByMultichainAddresses

   • 複数のネットワークにわたるアドレスのトークン残高を取得

   • 例: "0xabc...123 は Ethereum と Base でどのトークンを保有している？"

トランザクション履歴メソッド

6. fetchAddressTransactionHistory

   • 複数のネットワークにわたるアドレスのトランザクション履歴を取得

   • 例: "Ethereum 上のウォレット 0xdef...456 の最近のトランザクションを表示して"

7. fetchTransfers

   • 高度なフィルタリングオプションを使用して詳細な資産転送データを取得

   • 例: "0xghi...789 への、または 0xghi...789 からのすべての ERC-20 転送を表示して"

NFT メソッド

8. fetchNftsOwnedByMultichainAddresses

   • スパムフィルタリングを使用して、アドレスが所有するすべての NFT を取得

   • 例: "0xjkl...012 はどの NFT を所有している？"

9. fetchNftContractDataByMultichainAddress

   • アドレスの NFT コントラクトデータを取得

   • 例: "0xmno...345 はどの NFT コレクションのトークンを持っている？"

トランザクションメソッド

10. sendTransaction

    • スマートコントラクトアカウントを介してトランザクションを送信

    • ⚠️ 重要: AGENT_WALLET_SERVER 環境変数が設定されたウォレットエージェントサーバーが必要

    • 例: "0.1 ETH を 0xpqr...678 に送金して"

スワップメソッド

11. swap

    • DEX プロトコル（Uniswap）を介してトークンスワップを実行

    • ⚠️ 重要: AGENT_WALLET_SERVER 環境変数が設定されたウォレットエージェントサーバーが必要

    • 例: "100 USDC を ETH にスワップして"

ローカル開発とオープンソースへの貢献

インストール

1. リポジトリをクローン

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

2. 依存関係をインストール

pnpm install

開発

pnpm watch

本番環境向けビルド

pnpm build

デバッグのための MCP Inspector の使用

MCP Inspector は、メソッドをテストするための視覚的なインターフェースを提供し、MCP サーバーのデバッグを支援します：

pnpm inspector

これにより MCP Inspector が起動し、ブラウザからアクセスできるようになります。以下のことが可能です：

• 利用可能なすべてのメソッドを確認する

• さまざまなパラメータでメソッドをテストする

• レスポンスデータを表示する

• MCP サーバーの問題をデバッグする

貢献

プルリクエストを歓迎します。大きな変更を行う場合は、まず Issue を作成して変更内容について議論してください。

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。これは、MIT ライセンスの条件に従い、ソフトウェアを自由に使用、変更、配布できることを意味します。

プロンプト例

AI エージェントで使用できるプロンプトの例をいくつか紹介します：

What's the current price of Bitcoin and Ethereum?

Show me the NFTs owned by the wallet 0x1234...5678 on Ethereum.

What tokens does wallet 0xabcd...6789 hold across Ethereum and Base?

Get me the transaction history for 0x9876...5432.

Show me the price history of Ethereum from January 1st to today with daily intervals.

Get me Bitcoin price data for the last week with hourly intervals.

Show me ETH price performance for the past month.

What ERC-20 transfers happened to address 0x1234...5678 in the last 100 blocks?

API リファレンス

Alchemy の API に関する詳細については、以下を参照してください：

• Alchemy API ドキュメント