什么是 MCP 服务器？

MCP 服务器是一个遵循 Model Context Protocol 的工具，旨在帮助应用程序向大型语言模型（LLMs）提供上下文信息。它实现了上下文管理的标准化，使得开发者可以轻松集成不同类型的资源和服务。

如何使用 MCP 服务器？

只需几步即可启动 MCP 服务器并与之交互。首先安装 SDK，然后配置服务器参数并运行。最后，您可以开始请求资源或执行特定任务。

适用场景

MCP 服务器非常适合需要增强语言模型能力的应用程序，例如知识管理系统、客服机器人、内容生成工具等。

主要功能

上下文管理支持多种数据源的统一访问，如本地文件、数据库等。

协议兼容性完全符合 MCP 协议标准，确保跨平台互操作性。

资源动态加载实时响应资源请求，优化性能。

优势与局限性

优势

简化上下文传递流程，提升开发效率。

支持多种传输方式（如 STDIO 和 SSE），灵活性高。

开源社区支持活跃，便于扩展和维护。

局限性

初次配置可能需要一定的技术背景。

某些高级功能依赖底层实现的支持。

如何使用

安装 MCP SDK

通过 npm 安装 MCP SDK：`npm install @modelcontextprotocol/sdk`。

创建 MCP 服务器

编写一个简单的 MCP 服务器脚本，用于处理请求并返回结果。

启动服务器

运行服务器脚本，使其监听客户端请求。

使用案例

示例 1：列出资源展示如何列出服务器上已注册的所有资源。

示例 2：读取文件内容演示如何从服务器读取指定文件的内容。

常见问题

MCP 服务器是否支持自定义资源类型？

如何调试 MCP 客户端与服务器之间的通信？

🚀 MCP TypeScript SDK

本 SDK 使用 TypeScript 实现了 Model Context Protocol (MCP)，具备完整的客户端和服务端功能，能轻松集成到大语言模型（LLM）的交互界面中，为应用与 LLM 的交互提供便利。

🚀 快速开始

Model Context Protocol 支持应用程序以标准化方式为 LLM 提供上下文信息，将上下文提供与实际的 LLM 交互解耦。此 TypeScript SDK 实现了完整的 MCP 标准规范，具备以下优势：

可构建能连接到任何 MCP 服务端的客户端。
能创建暴露资源、提示和工具的 MCP 服务端。
支持使用标准传输方式，如 stdio 和 SSE。
可处理所有 MCP 协议消息和生命周期事件。

📦 安装指南

使用以下命令进行安装：

npm install @modelcontextprotocol/sdk

💻 使用示例

基础用法

创建客户端

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

const transport = new StdioClientTransport({
  command: "path/to/server",
});

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

await client.connect(transport);

// 列出可用资源
const resources = await client.request(
  { method: "resources/list" },
  ListResourcesResultSchema
);

// 读取特定资源
const resourceContent = await client.request(
  {
    method: "resources/read",
    params: {
      uri: "file:///example.txt"
    }
  },
  ReadResourceResultSchema
);

创建服务端

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: {
    resources: {}
  }
});

server.setRequestHandler(ListResourcesRequestSchema, async () => {
  return {
    resources: [
      {
        uri: "file:///example.txt",
        name: "Example Resource",
      },
    ],
  };
});

server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
  if (request.params.uri === "file:///example.txt") {
    return {
      contents: [
        {
          uri: "file:///example.txt",
          mimeType: "text/plain",
          text: "This is the content of the example resource.",
        },
      ],
    };
  } else {
    throw new Error("Resource not found");
  }
});

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