MCP 服务器

MCP Server

MCP 服务器通过提供用户友好的 API 来创建自定义工具和高效地管理服务器工作流程，从而简化了模型上下文协议的实施。

README

mcp-server

[!IMPORTANT] 为了更好地组织 AI 开发者的工具和服务，我们已将项目迁移至 Agentico。我们鼓励您使用新的包，并关注 Agentico 的 GitHub 仓库上的更新。

MCP Server 是一个简单的服务器，它实现了模型上下文协议 (MCP)，以提供更简单的 API 来与模型上下文协议交互。

为什么使用这个服务器？

在 "La Rebelion" 中，我们正在开发一套工具和服务，以简化流程和工作流程，从而提供更好、更高效的开发者体验。这个服务器是这套工具的一部分。

MCP 非常棒，但入门可能会有些令人困惑。我们创建了一个外观模式来简化创建实现模型上下文协议的服务器的过程。该模式很简单，您只需要使用自己的逻辑创建 tools，注册这些工具并启动服务器即可。

创建新服务器的步骤

将来，我们将提供一个 CLI 来创建一个类似于 MCP create server 的新服务器，但目前您可以按照以下基于官方文档创建服务器的步骤进行操作。

mkdir -p my-server/src
cd my-server/
yarn init -y
yarn add @modelcontextprotocol/sdk zod zod-to-json-schema
yarn add -D @types/node typescript
# 魔法就在这里
yarn add @la-rebelion/mcp-server

您需要更新 package.json 文件并创建一个 tsconfig.json 文件。

快速开始

使用您的自定义逻辑实现您的工具，并在 MCPServer 中注册它们。这是一个简单的 echo 工具的示例：

import { Tool, ToolSchema } from "@la-rebelion/mcp-server";

export class EchoTool extends Tool {
  toolSchema: ToolSchema = { 
    name: "echo",
    description: "回显输入的消息",
    schema: { // 工具所需的参数的 schema
      type: "object",
      properties: {
        message: { type: "string" },
      },
      required: ["message"],
    },
  };

  /**
   * 您的逻辑在这里，实现 execute 方法来定义工具的行为
   * @param input 输入消息 - 使用 schema 来定义输入类型
   * @returns 在示例中，我们正在回显消息
   */
  async execute(input: any): Promise<any> {
    // 这是一个简单的 echo 工具演示，没什么特别的，只是回显消息
    return Promise.resolve({
      content: [
        {
          type: "text",
          text: `${input.message}` 
        }
      ]
      });
  }
}

创建一个包含以下内容的 index.ts 文件：

#!/usr/bin/env node
import { MCPServer } from '@la-rebelion/mcp-server'
import { EchoTool } from "./tools/EchoTool.js";

const myServer = new MCPServer('My MCP Server', '1.0.0');

async function main() {
  // 注册工具
  myServer.registerTool("echo", EchoTool);
  await myServer.run();
}

main().catch((error) => {
  console.error("Server error:", error);
  process.exit(1);
});