Agentico MCP Server

🚀 MCP Server

MCP Server is a simple server that implements the Model Context Protocol (MCP), providing a more concise API to interact with the model context protocol.

🚀 Quick Start

Implement tools with your own logic and register them in the MCPServer. Here is a simple example of an echo tool:

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

export class EchoTool extends Tool {
  toolSchema: ToolSchema = { 
    name: "echo",
    description: "Echoes the input message",
    schema: { // The parameter schema required by the tool
      type: "object",
      properties: {
        message: { type: "string" },
      },
      required: ["message"],
    },
  };

  /**
   * Implement your logic here to define the behavior of the tool
   * @param input The input message - Use the schema to define the input type
   * @returns In this example, we simply echo the message
   */
  async execute(input: any): Promise<any> {
    // This is a simple demonstration of an echo tool, with no complex functionality, just echoing the message
    return Promise.resolve({
      content: [
        {
          type: "text",
          text: `${input.message}` 
        }
      ]
      });
  }
}

Create an index.ts file with the following content:

#!/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() {
  // Register the tool
  myServer.registerTool("echo", EchoTool);
  await myServer.run();
}

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

That's it! You've created a simple server that implements the Model Context Protocol. Test it using Claude Desktop or any other MCP - supported client.

Build the project using the following command:

yarn build

✨ Features

Why Use This Server?

In "La Rebelion", we're developing a series of tools and services aimed at simplifying processes and workflows to enhance developers' efficiency. This server is part of our toolset.

MCP is very powerful, but it can be a bit challenging for beginners to get started. We've created a Facade to simplify the process of creating a server using MCP. The pattern is straightforward: you just need to create tools with your own logic, register the tools, and start the server.

📦 Installation

In the future, we'll provide a CLI tool to create new servers similar to MCP create server. For now, you can create a server based on the official documentation by following these steps:

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
# Here is the magic
yarn add @agentico/mcp-server

You need to update the package.json file and create a tsconfig.json file.

📚 Documentation

Components

• MCPServer: The core server for managing tools and handling incoming requests.
• Tool and ToolSchema: Tool interfaces that define how to interact with external systems.
• main(): The main function that starts the server and connects everything together.

Support

You can support us in various ways:

You can find more information on supporting us at La Rebelion GitHub Sponsors, or support us by purchasing "La Rebelion" merchandise.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.