Excel Master

TypeScript实现的MCP协议SDK，用于构建与LLM交互的标准化服务

开发者工具人工智能聊天机器人 #LLM交互 #协议SDK #上下文管理 #工具集成 .JavaScript

评分 : 2.5分

下载量 : 6.6K

更新时间 : 2025-04-28

打开站点

什么是 MCP 服务器？

MCP 服务器是一种标准化的应用程序接口，用于为语言模型提供上下文数据和功能支持。它通过资源、工具和提示模板实现人机交互，使开发者能够轻松构建高效且安全的 AI 应用。

如何使用 MCP 服务器？

MCP 服务器可以通过简单的安装和配置快速启动。您可以创建自定义工具、资源和提示模板，从而满足具体需求。服务器支持多种传输协议，如标准输入输出和 HTTP SSE。

适用场景

MCP 服务器广泛适用于需要动态数据加载、外部功能调用以及交互式对话的场景，例如智能客服、知识管理系统和自动化开发工具。

主要功能

资源管理

允许您定义静态或动态资源，用于向语言模型提供上下文数据。

工具集成

支持创建和部署执行复杂任务的工具，例如计算、数据库查询等。

提示模板

预定义提示模板，帮助语言模型更好地理解用户意图。

多传输协议

支持多种通信方式（如 stdio 和 HTTP SSE），方便与不同客户端对接。

优势

统一接口标准，简化开发流程。

支持多场景应用，灵活性强。

强大的扩展能力，可根据需求定制功能。

局限性

对于高级功能可能需要一定的编程基础。

某些工具的性能依赖于后端实现效率。

如何使用

安装 MCP SDK

运行以下命令安装 MCP TypeScript SDK：`npm install @modelcontextprotocol/sdk`。

初始化 MCP 服务器

创建一个新的 MCP 服务器实例并配置基本信息，例如名称和版本。

添加资源、工具和提示模板

根据需求定义资源、工具和提示模板，确保它们能够满足应用场景。

连接到传输层

选择合适的传输协议（如 stdio 或 HTTP SSE）来连接客户端。

使用案例

计算器工具

实现一个简单的加法工具，用于演示工具功能。

SQLite 数据库查询

利用 SQLite 数据库查询工具获取用户信息。

常见问题

MCP 服务器是否支持多语言环境？

如何调试 MCP 服务器？

🚀 MCP TypeScript 软件开发工具包（SDK）文档

MCP TypeScript SDK 是用于构建与 MCP 协议交互的服务器和客户端的工具包。它提供了便捷的安装方式和丰富的使用示例，帮助开发者快速上手。

🚀 快速开始

你可以通过 npm 轻松安装 MCP TypeScript SDK，然后使用示例代码创建 MCP 服务器和客户端。

📦 安装指南

通过 npm 安装

你可以使用以下命令通过 npm 安装 MCP TypeScript SDK：

npm install @modelcontextprotocol/typescript-sdk

💻 使用示例

基础用法

创建 MCP 服务器

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  {
    name: "example-server",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

server.setRequestHandler(ListPromptsRequestSchema, async () => {
  return {
    prompts: [{
      name: "example-prompt",
      description: "An example prompt template",
      arguments: [{
        name: "arg1",
        description: "Example argument",
        required: true
      }]
    }]
  };
});

server.setRequestHandler(GetPromptRequestSchema, async (request) => {
  if (request.params.name !== "example-prompt") {
    throw new Error("Unknown prompt");
  }
  return {
    description: "Example prompt",
    messages: [{
      role: "user",
      content: {
        type: "text",
        text: "Example prompt text"
      }
    }]
  };
});

const transport = new StdioServerTransport();
await server.connect(transport);

创建 MCP 客户端

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "node",
  args: ["server.js"]
});

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

await client.connect(transport);

// 列举提示
const prompts = await client.listPrompts();

// 获取一个提示
const prompt = await client.getPrompt("example-prompt", {
  arg1: "value"
});

// 列举资源
const resources = await client.listResources();

// 读取资源
const resource = await client.readResource("file:///example.txt");

// 调用工具
const result = await client.callTool("example-tool", {
  arg1: "value"
});

高级用法

低级服务器类

如果你需要更多控制，可以直接使用低级 Server 类：

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new Server(
  {
    name: "example-server",
    version: "1.0.0"
  },
  {
    capabilities: {
      prompts: {},
      resources: {},
      tools: {}
    }
  }
);

server.setRequestHandler(ListPromptsRequestSchema, async () => {
  return {
    prompts: [{
      name: "example-prompt",
      description: "An example prompt template",
      arguments: [{
        name: "arg1",
        description: "Example argument",
        required: true
      }]
    }]
  };
});

server.setRequestHandler(GetPromptRequestSchema, async (request) => {
  if (request.params.name !== "example-prompt") {
    throw new Error("Unknown prompt");
  }
  return {
    description: "Example prompt",
    messages: [{
      role: "user",
      content: {
        type: "text",
        text: "Example prompt text"
      }
    }]
  };
});

const transport = new StdioServerTransport();
await server.connect(transport);