AISDK-MCP 通讯桥接器

简介

AISDK-MCP 是一个用于连接 AI SDK 和 MCP（机器学习平台）的桥梁工具。它允许您直接在 AI 应用程序中使用 MCP 的强大功能。

特性:

• 支持多种 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);

配置

配置文件格式

{
  "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 文件获取详细信息。