Alchemy MCP Server

🚀 Alchemy MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を利用し、AI エージェントが構造化された方法で Alchemy のブロックチェーン API とやり取りできるようにします。これにより、エージェントはコードを書かずに直接ブロックチェーンデータを照会できます。

🚀 クイックスタート

この MCP サーバーは、AI エージェントと Alchemy のブロックチェーン API の間に橋渡しをし、エージェントが以下のことを可能にします。

• トークン価格と価格履歴を照会する
• NFT 所有者情報を取得する
• 取引記録を確認する
• 複数のブロックチェーンネットワークでのトークン残高を確認する
• 資産移転を検索する
• その他多数！

クイックセットアップ

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

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

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

✨ 主な機能

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

トークン価格メソッド

1. fetchTokenPriceBySymbol

   • シンボルに基づいて現在のトークン価格データを取得する
   • 例："ETH と BTC の現在の価格はいくらですか？"

2. fetchTokenPriceByAddress

   • コントラクトアドレスに基づいて現在のトークン価格データを取得する
   • 例："0x1234...5678 アドレスの ETH の価格はいくらですか？"

3. fetchTokenPriceHistoryBySymbol

   • トークンの過去の価格データを取得する
   • 例："2023 年 1 月 1 日から 2 月 1 日までの BTC の毎日の価格履歴を表示してください"

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

4. fetchTokensOwnedByMultichainAddresses
   • 複数のネットワークアドレスのトークン残高を取得する
   • 例："0xabc...123 が Ethereum と Base ネットワークで保有しているトークンは何ですか？"

取引記録メソッド

5. fetchMultichainWalletAddressTransactionHistory

   • マルチチェーンウォレットアドレスの取引履歴を取得する
   • 例："0xdef...456 アドレスの Ethereum ネットワークでの最近の取引記録を表示してください"

6. fetchTransfers

   • アドレスのトークン移転データを取得する
   • 例："0xghi...789 へのまたはそこからのすべての ERC - 20 移転を表示してください"

NFT メソッド

7. fetchNftsOwnedByMultichainAddresses

   • 複数のアドレスが保有するすべての NFT を取得する
   • 例："0xjkl...012 アドレスが保有している NFT は何ですか？"

8. fetchNftContractDataByMultichainAddress

   • 複数のアドレスの NFT コントラクトデータを取得する
   • 例："0xmno...345 アドレスが関与している NFT コレクションシリーズは何ですか？"

📦 インストール

リポジトリのクローン

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

依存関係のインストール

npm install

💻 使用例

基本的な使用法

以下は使用例です。

トークン価格の照会

curl -X POST http://localhost:3000/api/v1/queryTokenPrice \
  -H "Content-Type: application/json" \
  -d '{"symbol": "ETH"}'

NFT 情報の取得

curl -X POST http://localhost:3000/api/v1/getNfts \
  -H "Content-Type: application/json" \
  -d '{"address": "0xjkl...012"}'

🔧 技術詳細

テストの実行

npm test

プロジェクトのビルド

npm run build

ローカル開発サーバーの起動

npm start

オープンソースへの貢献

コミュニティからの貢献を歓迎します！貢献方法については CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT License の保護を受けています。

📚 ドキュメント

完全な API ドキュメントは API DOCS を参照してください。

上記の内容を参考に、Alchemy MCP サーバーを使ってブロックチェーンとのやり取りを始めることができます。