MCP 服务器

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

为什么使用此服务器？

在 "La Rebelion" 中，我们正在开发一系列工具和服务，旨在简化流程和工作流，以提高开发者的效率体验。这个服务器是我们工具集的一部分。

MCP 非常强大，但对于新手来说可能有点难以入门。我们创建了一个 门面 来简化使用 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
# 这里是 magic
yarn add @agentico/mcp-server

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

快速入门

用你自己的逻辑实现工具，并在 MCPServer 中注册它们。以下是一个简单的 echo 工具示例：

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

export class EchoTool extends Tool {
  toolSchema: ToolSchema = { 
    name: "echo",
    description: "Echoes the input message",
    schema: { // 工具所需的参数模式
      type: "object",
      properties: {
        message: { type: "string" },
      },
      required: ["message"],
    },
  };

  /**
   * 在这里实现你的逻辑，定义工具的行为
   * @param input 输入消息 - 使用模式定义输入类型
   * @returns 示例中，我们只是简单地回显消息
   */
  async execute(input: any): Promise<any> {
    // 这是一个简单的回显工具演示，没有复杂的功能，只是回显消息
    return Promise.resolve({
      content: [
        {
          type: "text",
          text: `${input.message}` 
        }
      ]
      });
  }
}

创建一个 index.ts 文件，内容如下：

#!/usr/bin/env node
import { MCPServer } from '@agentico/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("服务器错误:", error);
  process.exit(1);
});

就这样！你已经创建了一个实现模型上下文协议的简单服务器。使用 Claude Desktop 或任何支持 MCP 的其他客户端进行测试。

使用以下命令构建项目：

yarn build

组件

• MCPServer: 用于管理工具和处理传入请求的核心服务器。
• Tool 和 ToolSchema: 定义如何与外部系统交互的工具接口。
• main(): 启动服务器并将所有内容连接在一起的主函数。

支持

你可以通过多种方式支持我们：

你可以在 La Rebelion GitHub Sponsors 找到更多支持我们的信息，或者通过购买 "La Rebelion" 商品 来支持我们。

许可证

该项目在 MIT License 下许可 - 有关详细信息，请参阅 LICENSE 文件。