ToolSDK.ai：快速连接AI工具与MCP服务器的免费SDK

ToolSDK.ai 是一个为开发者设计的免费 TypeScript 软件开发工具包（SDK），专注于连接和管理 Model Context Protocol（MCP）服务器与 AI 工具。它的核心目标是简化开发者在 AI 应用开发中整合多个 MCP 服务器的复杂性。用户只需一行代码，就能快速接入超过 5000 个 MCP 服务器和 10,000 种 AI 工具，构建高效的 AI 代理或自动化工作流。ToolSDK.ai 支持主流框架如 Next.js 和 React，适合快速开发 AI 驱动的应用。它的开放性允许开发者通过 GitHub 仓库添加自定义 MCP 服务器，增强灵活性。

功能列表

• 提供 TypeScript SDK，支持一行代码接入 5000+ MCP 服务器和 10,000+ AI 工具。
• 支持与 OpenAI SDK 和 Vercel AI SDK 无缝集成，简化开发流程。
• 允许开发者通过 GitHub 仓库添加和注册自定义 MCP 服务器。
• 支持构建类似 Zapier、n8n 的自动化工作流应用。
• 提供 AI 代理开发功能，快速搭建能处理复杂任务的智能体。
• 兼容主流框架如 React、Next.js、Svelte 和 Node.js。
• 提供结构化的 JSON 配置文件，自动生成 README 和 npm 包。

使用帮助

安装流程

ToolSDK.ai 是一个基于 TypeScript 的工具包，安装和使用需要一定的开发环境基础。以下是详细的安装步骤：

1. 准备开发环境
   确保你的电脑已安装 Node.js 18+ 和 pnpm 包管理器。Node.js 提供运行时环境，pnpm 用于高效管理依赖。
   • 下载 Node.js：访问 Node.js 官网，选择 LTS 版本（推荐 18.x 或更高）。
   • 安装 pnpm：运行命令

     npm install -g pnpm
     

   • 验证安装：运行 node -v 和 pnpm -v，确认版本号正常输出。
2. 安装 ToolSDK.ai
   ToolSDK.ai 目前通过 GitHub 仓库分发，需克隆其代码或直接使用 npm 包（视具体发布情况）。以下假设通过 npm 安装：
   • 创建项目文件夹，进入目录：

     mkdir my-ai-project
     cd my-ai-project
     

   • 初始化项目并安装 ToolSDK.ai：

     pnpm init
     pnpm add @toolsdk-ai/core
     

   • 如果需要特定的 MCP 服务器（如 GitHub API 服务器），安装对应包：

     pnpm add @modelcontextprotocol/server-github
     

3. 配置环境变量
   某些 MCP 服务器（如 GitHub API）需要 API 密钥。例如，GitHub 服务器需要 GITHUB_PERSONAL_ACCESS_TOKEN。
   • 生成 GitHub 个人访问令牌：登录 GitHub，进入“设置 > 开发者设置 > 个人访问令牌”，创建新令牌。
   • 在项目根目录创建 .env 文件，添加：

     GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
     

使用主要功能

ToolSDK.ai 的核心功能是快速连接 MCP 服务器和 AI 工具，构建 AI 代理或自动化工作流。以下是主要功能的详细操作步骤：

功能 1：一行代码接入 MCP 服务器

ToolSDK.ai 的最大特色是简洁性。开发者只需一行代码即可调用 MCP 服务器。例如，连接 GitHub API 服务器：

import { ToolSDK } from '@toolsdk-ai/core';
const github = ToolSDK.connect('@modelcontextprotocol/server-github');

• 操作步骤：
  1. 确保已安装 @modelcontextprotocol/server-github 包。
  2. 在代码中导入 ToolSDK，并使用 connect 方法指定服务器包名。
  3. 调用服务器功能，例如获取 GitHub 仓库信息：

     const repo = await github.getRepo('owner/repo');
     console.log(repo);
     

功能 2：构建 AI 代理

ToolSDK.ai 支持快速搭建 AI 代理，结合 AI 模型和 MCP 服务器处理复杂任务。

• 操作步骤：
  1. 安装 AI SDK（如 OpenAI 或 Vercel AI SDK）：

     pnpm add @ai-sdk/openai
     

  2. 配置 AI 模型和 MCP 服务器：

     import { generateText } from 'ai';
     import { openai } from '@ai-sdk/openai';
     import { ToolSDK } from '@toolsdk-ai/core';
     const github = ToolSDK.connect('@modelcontextprotocol/server-github');
     const { text } = await generateText({
     model: openai('gpt-4o'),
     prompt: 'Summarize the README of owner/repo',
     tools: [github],
     });
     console.log(text);
     

  3. AI 模型会自动调用 MCP 服务器获取数据并生成结果。

功能 3：创建自动化工作流

ToolSDK.ai 支持构建类似 Zapier 的自动化工作流。例如，自动从 GitHub 获取 issue 数据并发送到 Slack。

• 操作步骤：
  1. 安装 Slack MCP 服务器包：

     pnpm add @modelcontextprotocol/server-slack
     

  2. 配置工作流：

     const slack = ToolSDK.connect('@modelcontextprotocol/server-slack');
     const issues = await github.getIssues('owner/repo');
     await slack.sendMessage('#channel', `New issues: ${issues.length}`);
     

  3. 运行代码，自动化发送消息到指定 Slack 频道。

功能 4：添加自定义 MCP 服务器

开发者可通过 GitHub 仓库添加自定义 MCP 服务器。

• 操作步骤：
  1. 访问 ToolSDK.ai GitHub 仓库。
  2. Fork 仓库，在 packages/uncategorized 文件夹下创建新文件，例如 my-mcp-server.json。
  3. 编辑 JSON 文件，定义服务器信息：

     {
     "type": "mcp-server",
     "name": "MyServer",
     "packageName": "@myorg/server-myserver",
     "description": "Custom MCP server",
     "url": "https://github.com/myorg/servers",
     "runtime": "node",
     "license": "MIT"
     }
     

  4. 提交 Pull Request，等待 AI 自动分类和生成 npm 包。

注意事项

• 确保环境变量正确配置，避免 API 调用失败。
• ToolSDK.ai 的 MCP 服务器生态仍在扩展，部分服务器可能需要额外配置。
• 定期检查 GitHub 仓库更新，获取最新 MCP 服务器列表。

应用场景

1. 快速开发 AI 代理
   开发者可以使用 ToolSDK.ai 快速构建 AI 代理，连接 GitHub API 获取代码仓库数据，并通过 AI 模型生成代码分析报告。适合独立开发者或初创团队快速原型开发。
2. 自动化工作流
   企业可利用 ToolSDK.ai 搭建自动化工作流，例如监控 GitHub 仓库的 issue 更新并自动通知团队，减少手动操作，提高效率。
3. 扩展自定义工具
   开发者可以通过添加自定义 MCP 服务器，扩展 ToolSDK.ai 功能，例如连接内部数据库或第三方 API，满足特定业务需求。

QA

1. ToolSDK.ai 是否免费？
   是的，ToolSDK.ai 提供免费的 TypeScript SDK，开发者可免费使用核心功能。部分 MCP 服务器可能需要 API 密钥或付费订阅（如 GitHub API 的高级功能）。
2. 需要哪些开发经验？
   用户需要基本的 TypeScript 或 JavaScript 开发经验，熟悉 Node.js 和 pnpm。了解 API 调用和环境变量配置有助于更快上手。
3. 如何获取最新的 MCP 服务器列表？
   访问 ToolSDK.ai GitHub 仓库，查看 packages-list.json 文件，获取最新服务器列表。