Aisdk MCP Bridge

🚀 AISDK-MCP 通信ブリッジ

AISDK-MCPは、AI SDKとMCP（機械学習プラットフォーム）を接続するためのツールです。これにより、AIアプリケーション内で直接MCPの強力な機能を利用することができます。

🚀 クイックスタート

📦 インストール

npm install aisdk-mcp

💻 使用例

基本的な使用法

const { AISDKMCP } = require('aisdk-mcp');

async function main() {
    // 初始化 MCP 桥接器
    const mcpBridge = new AISDKMCP({
        configPath: 'config/mcp-config.json', // 配置文件路径
        debug: true // 启用调试日志
    });

    // 获取 MCP 工具集
    const tools = await mcpBridge.getMCPTools({ serverName: 'twitter-mcp' });

    // 执行具体功能
    const result = await executeMCPFunction('twitter-mcp', 'postTweet', {
        text: 'Hello from MCP!'
    });
}

main().catch(console.error);

✨ 主な機能

• 複数のMCPサービスをサポート
• 簡単な設定と拡張性
• 組み込みのエラー処理とログ記録
• 高性能な通信

📚 ドキュメント

設定

設定ファイル形式

{
  "mcpServers": {
    "twitter-mcp": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "PORT": "3000"
      },
      "mode": "stdio", // 或 'sse'
      "sseOptions": {
        "endpoint": "ws://localhost:3000/ws",
        "headers": {},
        "reconnectTimeout": 5000
      }
    },
    "fire-crawl": {
      "command": "python",
      "args": ["script.py"],
      "env": {
        "API_KEY": "your_api_key"
      }
    }
  }
}

コアインターフェース

getMCPTools(options)

MCPと互換性のあるAIツールを取得します。

interface ToolOptions {
  debug?: boolean;
  serverName?: string;
}

async function getMCPTools(options: ToolOptions): Promise<ToolSet>;

executeMCPFunction(serverName, functionName, args)

特定のMCPサーバー上で直接機能を実行します。

async function executeMCPFunction(
    serverName: string,
    functionName: string,
    args: Record<string, unknown>
): Promise<MCPToolResult>;

エラー処理

ブリッジには包括的なエラー処理が含まれています：

• サーバーの初期化失敗
• 通信エラー
• ツールの実行エラー
• 設定問題
• サーバー接続問題

ログ記録

デバッグログ

環境変数を設定することで、詳細なデバッグログを有効にします。

# 启用所有调试日志
DEBUG=* npm start

# 启用 MCP 调试日志
DEBUG=mcp npm start

# 启用所有 MCP 命名空间日志
DEBUG=mcp:* npm start

ログタイプ

ログシステムは以下のタイプをサポートしています：

• 操作ログ
• エラーログ
• 警告ログ
• 情報ログ

ログファイル

デフォルトでは、ログはコンソールに出力されます。設定により、ログをファイルに書き込むことができます。

開発ガイド

依存関係のインストール

npm install uuid express ws

新しいサーバーの作成

server.js または script.py の例を参考に、カスタムMCPサーバーを作成します。

貢献ガイド

1. リポジトリをForkします。
2. 機能ブランチを作成します。
3. 変更をコミットし、Pull Requestを作成します。

サポート情報

問題が発生した場合は、GitHub Issues を訪問するか、support@aisdk-mcp.comにメールを送信してください。

変更履歴

1.0.0（2023-10-05）

• 初期バージョンのリリース
• 基本機能の追加
• ドキュメントの作成

セキュリティに関する注意事項

セキュリティホールを発見した場合は、すぐにsecurity@aisdk-mcp.comに報告してください。

作者情報

• 開発者: AI SDKチーム
• メール: contact@aisdk-mcp.com

📄 ライセンス

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