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 文件獲取詳細信息。