工具 AI 工具 AI

大模型的得力干将MCP(2) - 开发服务

麦金叔的AI之旅2025-05-142025-05-14

今天我们将继续学习，基于model context protocol的SDK来开发自己的MCP服务。

等系列课学习完成，你将能了解什么是MCP，如何开发MCP和如何实际使用它（当然我们会回归到Dify中，配合LLM，更加完善我们的AI应用适用场景）。

01.动手准备

今天就来展开说说开发MCP应用，应该如何做。既然是开发，那就离不开代码了。处理的顺序正好和概念反过来，我们先来实现一个MCP服务端。

同时需要理解两个重要的概念：

1 通信机制

MCP协议支持两种主要的通信机制：基于标准输入输出的本地通信和基于SSE(Server-Sent Events)的远程通信。

也就是说MCP服务端，根据和客户端连接时所在的位置不同，分成本地通信和远程通信。

本地通信是通过stdio传输数据，即数据是本地机器的进程间通信。适合AI助手工具等软件使用。

而远程通信则是利用SSE技术，通过HTTP来通信和传输数据。适合于共享MCP服务，在企业内使用或者服务给互联网用户。

2 运行语言和环境

一般涉及到开发，必定是要和开发语言有关。但是MCP协议是和语言无关的，也就是说大家可以尽量使用自己熟悉的开发语言。

Anthropic提供了TypeScript SDK，Python SDK，Java SDK，C# SDK，甚至Swift SDK和Rust SDK。也就是说基本上任何语言都可以实现MCP服务。

为了降低难度，我们不用挑战从零开始，用全新的语言做开发，就从typescript-sdk开始吧。

02.动手做一做

创建一个空的npm项目

npm init

输入如下信息

修改package.json文件，增加依赖包和运行脚本。

创建一个src目录并添加一个index.ts文件。内容如下，并替换自己的高德密钥。


import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
import { z } from "zod";
import https from 'https';
// 环境变量中的API密钥
const GAODE_API_KEY = process.env.GAODE_API_KEY? process.env.GAODE_API_KEY: "高德密钥";
// 通用HTTP请求函数
async function makeRequest(url: string): Promise<any> {
  return new Promise((resolve, reject) => {
    https.get(url, (res) => {
      let data = '';
      res.on('data', (chunk) => {
        data += chunk;
      });
      res.on('end', () => {
        try {
          resolve(JSON.parse(data));
        } catch (e) {
          reject(e);
        }
      });
    }).on('error', (err) => {
      reject(err);
    });
  });
}
// 创建MCP服务器
const server = new McpServer({
  name: "gaode-weather-mcp",
  version: "0.0.1"
});
// 实现天气查询
server.tool("getWeather",
  {
    city: z.string().describe("城市编码"),
    extensions: z.enum(["base", "all"]).optional().describe("气象类型：base(实况天气)、all(预报天气)")
  },
  async (params) => {
    if (!GAODE_API_KEY) {
      throw new Error("高德地图API密钥未设置");
    }
    const { city, extensions = "all" } = params;
    const url = `https://restapi.amap.com/v3/weather/weatherInfo?key=${GAODE_API_KEY}&city=${encodeURIComponent(city)}&extensions=${extensions}&output=json`;
    const result = await makeRequest(url);
    return {
      content: [{ type: "text", text: JSON.stringify(result) }]
    };
  }
);

// 启动服务器
async function main() {
  const transport = new StdioServerTransport();
  //const transport = new SSEServerTransport();
  await server.connect(transport);
  console.log("高德地图MCP服务已启动");
  // 保持运行
  await new Promise(() => { });
}

main().catch(console.error);