MCP 服务器创建指南

在创建 MCP（模型上下文协议）服务器时，理解其工作原理至关重要。MCP 服务器在非交互环境中运行，无法在运行时发起 OAuth 流程、打开浏览器窗口或提示用户输入。因此，所有凭据和身份验证令牌必须通过环境变量在 MCP 设置配置中提前提供。

MCP

1. MCP 服务器的基本概念

MCP 服务器的主要功能是提供工具和资源，允许用户通过 API 访问特定的数据或服务。例如，您可以创建一个 MCP 服务器来获取天气信息，使用 OpenWeather API 来实现。

2. 创建 MCP 服务器的步骤

以下是创建 MCP 服务器的基本步骤：

步骤 1: 初始化项目

使用 create-typescript-server 工具在默认的 MCP 服务器目录中启动一个新项目：

cd C:\Users\lvzp\Documents\Cline\MCP
npx @modelcontextprotocol/create-server weather-server
cd weather-server
npm install axios

这将创建一个新的项目结构。

步骤 2: 编写服务器代码

在 src/weather-server/index.ts 中编写服务器的主要实现代码。以下是一个简单的示例：

import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import axios from 'axios';

const API_KEY = process.env.OPENWEATHER_API_KEY; // 从环境变量获取 API 密钥
if (!API_KEY) {
  throw new Error('OPENWEATHER_API_KEY 环境变量是必需的');
}

// 服务器实现
class WeatherServer {
  private server: Server;

  constructor() {
    this.server = new Server({ name: 'weather-server', version: '0.1.0' });
    this.setupHandlers();
  }

  private setupHandlers() {
    // 设置处理器以响应请求
  }

  async run() {
    // 启动服务器
  }
}

const server = new WeatherServer();
server.run().catch(console.error);
步骤 3: 编译和运行
使用以下命令编译项目：

npm run build

然后，确保在 MCP 设置文件中添加服务器配置，包含 API 密钥等环境变量。

3. MCP 服务器的配置

在 MCP 设置文件中添加新服务器的配置，确保设置 disabled=false 和 autoApprove=[]。

    {
      "mcpServers": {
        "weather": {
          "command": "node",
          "args": ["/path/to/weather-server/build/index.js"],
          "env": {
            "OPENWEATHER_API_KEY": "用户提供的 API 密钥"
          }
        }
      }
    }

4. 测试和使用

完成配置后，系统将自动运行所有服务器，您可以通过命令访问新工具和资源。例如，您可以询问“旧金山的天气如何？”来获取天气信息。

MCP

结论
创建 MCP 服务器可以扩展您的应用程序功能，使其能够与外部 API 交互。通过遵循上述步骤，您可以轻松设置和配置自己的 MCP 服务器。