Apillon MCP Server

Apillon MCP サーバー

Apillon MCP サーバーのリポジトリへようこそ。このプロジェクトは、ストレージ、ホスティング、NFT の機能を提供するモジュールを備えたサーバーを、Model Context Protocol（MCP）を使用して実装しています。

Model Context Protocol（MCP）の概要

Model Context Protocol（MCP）は、アプリケーションが大規模言語モデル（LLM）にコンテキストを提供する方法を標準化するオープンプロトコルです。MCP は、AI アプリケーションの USB-C ポートのようなものだと考えてください。USB-C がさまざまな周辺機器やアクセサリーを接続する標準化された方法を提供するのと同じように、MCP は AI モデルをさまざまなデータソースやツールに接続する標準化された方法を提供します。

MCP を使うと、LLM を基盤としたエージェントや複雑なワークフローを構築できます。LLM はデータやツールとの連携を頻繁に必要とします。MCP は次のものを提供します。

• LLM に直接接続できる、事前構築済みの統合機能が増え続けるリスト。
• LLM プロバイダーやベンダーを柔軟に切り替える機能。
• インフラストラクチャ内でデータを保護するためのベストプラクティス。

詳しくは、Model Context Protocol の概要をご覧ください。

プロジェクト概要

このプロジェクトは Apillon が開発しており、次のモジュールのサーバー実装を提供します。

ストレージモジュール

ストレージモジュールは、包括的なファイル管理機能を提供します。

• ストレージバケットの作成と管理
• ディレクトリ構造に対応したファイルやフォルダーのアップロード
• バケット内のオブジェクト（ファイルやフォルダー）の一覧表示と管理
• コンテンツアドレス指定用の IPFS リンクの生成
• 永続的な名前付けのための IPNS レコードの管理
• ファイルやディレクトリの削除
• ファイルのステータスとメタデータの追跡

ホスティングモジュール

ホスティングモジュールを使用すると、ウェブアプリケーションをデプロイできます。

• ウェブサイトインスタンスの作成と管理
• ローカルフォルダーまたはバッファーからのウェブサイトファイルのアップロード
• ステージング環境と本番環境へのデプロイ
• デプロイステータスの監視
• デプロイの一覧表示と管理
• 複数のデプロイ環境への対応

NFT モジュール

NFT モジュールは、包括的な NFT 管理機能を提供します。

• さまざまなチェーン（EVM、Substrate、Unique）での NFT コレクションの作成
• コレクションパラメーター（名前、シンボル、ロイヤリティなど）の設定
• 指定したアドレスへの NFT のミント
• ネストされた NFT（ネスト可能なコレクション）への対応
• NFT のバーン／失効（失効可能なコレクションの場合）
• コレクションの所有権の移転
• トランザクションステータスの監視
• パラメーターを設定できるドロップへの対応

Claude での使用

この MCP を Claude LLM で使用するには、次の手順に従ってください。

1. Claude for Desktop をインストールする

2. Claude Desktop の設定ファイルを確認する

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

3. 設定を追加する

claude_desktop_config.json の設定をコピーし、ご自身のパラメーターに合わせて調整してください。

⚠️ 重要： API キーの環境変数と、ファイルシステム MCP で許可するディレクトリを必ず変更してください。

{
  "mcpServers": {
    "apillon-mcp-server": {
      "command": "npx",
      "args": ["-y", "@apillon/mcp-server"],
      "env": {
        "APILLON_API_KEY": "<APILLON_API_KEY>",
        "APILLON_API_SECRET": "<APILLON_API_SECRET>"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/your-username/Desktop"
      ]
    }
  }
}

4. Claude for Desktop を再起動する

変更を反映するには、設定後に Claude Desktop を再起動してください。 これで、テキストチャットだけを使って、利用可能なアクションを Claude に実行させることができます。

ローカル開発

前提条件

• Node.js 22 以上
• npm 11 以上
• TypeScript
• Apillon API キーとシークレット（https://app.apillon.io で生成できます）

インストール

リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/Apillon/mcp-server.git
cd mcp-server
npm install

ローカルの Claude Desktop 設定を変更する：

{
  "mcpServers": {
    "apillon-mcp-server": {
      "command": "tsx",
      "args": ["/full/path/to/index.ts"],
      "env": {
        "APILLON_API_KEY": "<APILLON_API_KEY>",
        "APILLON_API_SECRET": "<APILLON_API_SECRET>"
      }
    }
  }
}

サーバーの実行

サーバーをテストするには、上記の設定を使って Claude Dekstop を利用する方法を推奨します。 または、サーバーをローカルで起動するには、次のコマンドを使用してください。

npm start

プロジェクトのビルド

プロジェクトをビルドするには、次を実行します。

npm run build

貢献

Apillon MCP サーバーへの貢献を歓迎します。未対応のタスクやバグについては、issuesをご確認ください。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。

MCP Review

このMCPサーバーはMCP reviewの認定を受けています。

こちらのMCP Reviewページをご覧ください。

お問い合わせ

詳しくは、Apillonのウェブサイトをご覧いただくか、GitHub issuesからお問い合わせください。