A1d Image Video Mcp Tools

A1D MCP Server - 万能 AI ツール

あらゆる MCP 対応クライアントに AI 画像・動画処理ツールを提供する、強力な MCP（Model Context Protocol）サーバーです。セットアップ不要ですぐに使えます。

🤖 利用可能な AI ツール

ツール	説明	使用例
remove_bg	AI による背景除去	写真や商品画像から背景を除去
image_upscaler	AI による画像の高画質化	画像を2倍、4倍、8倍、16倍の解像度に拡大
video_upscaler	AI による動画の高画質化	動画の画質と解像度を向上
image_vectorization	ベクター形式に変換	画像を拡大可能な SVG グラフィックに変換
image_extends	画像のスマートな拡張	画像の境界をインテリジェントに拡張
image_generator	テキストから画像を生成する AI	テキストによる説明から画像を生成

🚀 クイックセットアップ（2分）

1. API キーを取得する

• A1D.ai にアクセスして、無料の API キーを取得します
• 任意：より多く利用する場合は、クレジットを購入します

2. MCP クライアントに接続する

Claude Desktop の場合： Claude Desktop の設定ファイルに以下を追加します。

{
  "mcpServers": {
    "a1d": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.a1d.ai/sse",
        "--header",
        "api_key:${MCP_API_KEY}"
      ],
      "env": {
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP Inspector の場合：

• 起動：npx @modelcontextprotocol/inspector
• トランスポートタイプ：SSE
• URL：https://mcp.a1d.ai/sse
• ヘッダーを追加：api_key: your_api_key_here

その他の MCP クライアントの場合：

• サーバー URL：https://mcp.a1d.ai/sse
• 認証：ヘッダー api_key: your_api_key_here

3. クライアントを再起動する

これで完了です！MCP クライアントで AI ツールを利用できるようになります。

💡 使い方

設定が完了したら、AI アシスタントに画像や動画の処理を依頼するだけです。

• 「この画像の背景を削除して」
• 「この画像を4倍の解像度に拡大して」
• 「この写真をベクターグラフィックに変換して」
• 「山の向こうに夕日が沈む画像を生成して」

🔧 設定のヘルプ

Claude Desktop 設定ファイルの場所

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

トラブルシューティング

ツールが表示されない場合

• 設定を追加した後、MCP クライアントを再起動します
• API キーが正しいことを確認します
• 設定ファイルの構文を確認します

接続に問題がある場合

# Test the connection directly
npx mcp-remote https://mcp.a1d.ai/sse --header "api_key:your_api_key"

必要に応じてキャッシュをクリアする

rm -rf ~/.mcp-auth

📚 リソース

• API ドキュメント - 詳細な API リファレンス
• API キーを取得 - 無料登録
• 料金 - クレジットパッケージ

🛠️ 開発者向け

ツールを追加したり、サーバーをカスタマイズしたりしたいですか？このリポジトリには、設定駆動型アーキテクチャを採用した完全なソースコードが含まれています。

ローカル開発

git clone https://github.com/AIGC-Hackers/a1d-mcp-server.git
cd a1d-mcp-server
npm install
npm run start

ローカルサーバーは http://localhost:8787 で起動します。リクエストに api_key ヘッダーを追加すると、API キーを使ってテストできます。

新しいツールの追加

src/config/tools.json を編集するだけで、コードを書かずに新しい AI ツールを追加できます。

{
  "name": "new_tool",
  "description": "Tool description",
  "apiEndpoint": "/api/endpoint",
  "inputSchema": { /* ... */ },
  "zodValidation": { /* ... */ }
}

詳しい手順については、docs/ADD_NEW_TOOL.md を参照してください。

🔐 セキュリティ

• ユーザー提供の認証情報：このサーバーでは、ユーザーがヘッダーを通じて自身の A1D API キーを提供する必要があります
• 秘密情報の保存なし：API キーはすべてリクエストヘッダー経由で渡され、サーバー側には保存されません
• 脆弱性の報告：責任ある情報開示については、SECURITY.md を参照してください

🤝 コントリビューション

コントリビューションを歓迎します。以下の手順に従ってください。

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 既存のコードスタイルに従います
4. 新機能のテストを追加します
5. プルリクエストを送信します

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルを参照してください。

---