Allyson

Allyson MCP Server

Allyson MCP Server - Model Context Protocol (MCP) を使用して、静的なファイルをアニメーション SVG コンポーネントに変換する AI 搭載アニメーションジェネレーターです。

🚀 クイックスタート

npx を使用したインストールと実行

npx allyson-mcp --api-key YOUR_API_KEY

🔧 設定

コマンドラインオプション

allyson-mcp [options]

Options:
  --api-key <key>     Your Allyson API key (required)
  --help              Show help message

Examples:
  allyson-mcp --api-key your-api-key-here
  API_KEY=your-key allyson-mcp

環境変数

API キーは環境変数として設定することも可能です:

export API_KEY=your-api-key-here
allyson-mcp

🎯 機能

• AI 搭載アニメーション生成: 静的な画像をアニメーション SVG コンポーネントに変換
• MCP プロトコル互換: MCP 互換の AI アシスタントやツールで動作
• ファイルアップロード対応: 様々な画像形式 (PNG, JPG, SVG など) をサポート
• カスタムアニメーションプロンプト: 希望するアニメーションを具体的に記述可能
• ローカルファイル処理: ローカルファイルシステムからファイルを読み取り
• 自動出力生成: アニメーションコンポーネントを指定パスに保存

🛠 利用可能なツール

generate_svg_animation

ソースファイルとアニメーションプロンプトからアニメーション SVG コンポーネントを生成します。

パラメーター:

• prompt (string, 必須): 生成するアニメーションの説明
  • 例: "キャラクターが手を振るように"
  • 例: "ボールにバウンドする動きを追加"
  • 例: "ロゴに回転エフェクトを作成"
• svg_path (string, 必須): ソースファイルへの絶対パス
  • 例: "/path/to/my-icon.svg"
• output_path (string, 必須): アニメーションコンポーネントを保存する絶対パス
  • 例: "/path/to/animated-component.tsx"

MCP クライアントでの使用例:

{
  "tool": "generate_svg_animation",
  "arguments": {
    "prompt": "Make the logo glow and pulse gently",
    "svg_path": "/Users/john/Desktop/company-logo.svg",
    "output_path": "/Users/john/project/src/components/AnimatedLogo.tsx"
  }
}

🔌 AI アシスタントとの統合

この MCP サーバーは、Model Context Protocol をサポートする以下のような AI アシスタントと連携するように設計されています:

• Claude Desktop (MCP 設定対応)
• Cursor IDE (MCP 統合対応)
• カスタム AI アプリケーション (MCP SDK 使用)

MCP 設定

{
  "mcpServers": {
    "allyson": {
      "command": "npx",
      "args": ["allyson-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

📝 例

基本的なアニメーション生成

# Start the server
allyson-mcp --api-key your-api-key

# The AI assistant can now use the tool:
# "Please animate this logo to have a subtle glow effect"
# File: /Users/john/logo.svg → /Users/john/animated-logo.tsx

🔐 セキュリティ

• API キー保護: API キーは Allyson サービスへ安全に送信されます
• ローカルファイルアクセス: 明示的に指定したファイルのみを読み取ります
• データ保存なし: ファイルは処理され、外部サーバーに保存されません
• HTTPS 通信: すべての API 通信は安全な HTTPS を使用します

🐛 トラブルシューティング

よくある問題

「API キーが必要です」エラー

# Solution: Provide API key via flag or environment variable
allyson-mcp --api-key YOUR_KEY
# or
export API_KEY=YOUR_KEY && allyson-mcp

「ファイルが見つかりません」エラー

# Make sure to use absolute paths
❌ Wrong: ./image.svg
✅ Correct: /Users/username/project/image.svg

「アニメーション API サーバーに接続できません」エラー

• インターネット接続を確認してください
• API キーが有効であることを確認してください
• Allyson サービスがアクセス可能であることを確認してください

権限の問題

# Make the file executable if needed
chmod +x node_modules/allyson-mcp/index.js

デバッグモード

デバッグには、stderr に出力されるサーバーログを確認できます:

allyson-mcp --api-key YOUR_KEY 2> debug.log

📋 要件

• Node.js: バージョン 18.0.0 以上
• API キー: 有効な Allyson API キー
• インターネット接続: API 通信に必要

🤝 コントリビューション

コントリビューションを歓迎します！詳細はコントリビューションガイドラインをご覧ください。

📄 ライセンス

Apache-2.0 License - 詳細は LICENSE ファイルを参照してください。

🔗 リンク

• Model Context Protocol
• Allyson ウェブサイト
• Issue Tracker

📞 サポート

• ドキュメント: この README とインラインヘルプ (--help) を確認してください
• 問題: バグは GitHub Issues で報告してください