Testmcpserver

🚀 Test MCP Server

This is a test server project implemented using Anthropic's Model Context Protocol (MCP). Here is a detailed introduction to the project:

🚀 Quick Start

Prerequisites

Before you start, make sure you have git and npm installed on your system.

Installation

1. Clone the repository

   git clone <Project URL>
   cd mcp-server-test
   

2. Install dependencies

   npm install
   

3. Build the project

   npm run build
   

Start the server

node src/index.js

✨ Features

Core Features

• Math Calculation Tool: Supports basic operations such as addition and multiplication.
• Error Handling: Provides comprehensive error capturing and feedback mechanisms.

📦 Installation

Step 1: Clone the Repository

git clone <Project URL>
cd mcp-server-test

Step 2: Install Dependencies

npm install

Step 3: Build the Project

npm run build

📚 Documentation

Project Structure

• src/controllers/MathsController.ts: Contains the processing logic for mathematical operations.
• src/definitions/maths/addition.ts: Definition file for the addition tool.

Code Examples

Basic Usage

// `src/definitions/maths/addition.ts`
export const ADDITION = {
  name: "addition",
  description: "Calculate the sum of two numbers.",
  parameters: [
    { type: "number", name: "a", description: "The first number" },
    { type: "number", name: "b", description: "The second number" }
  ],
  example: "{ a: 2, b: 3 }"
};

Advanced Usage

// `src/controllers/MathsController.ts`
export class MathsController {
  async handleAddition(a: number, b: number) {
    try {
      const result = a + b;
      return {
        content: [
          { type: "text", text: `The sum is: ${result}` }
        ],
        isError: false
      };
    } catch (error) {
      return {
        content: [
          { type: "text", text: `Calculation error: ${error instanceof Error ? error.message : String(error)}` }
        ],
        isError: true
      };
    }
  }
}

// `src/utils/toolRegistry.ts`
export const controllerMap = {
  addition: {
    controller: MathsController,
    handlerMethod: "handleAddition"
  }
};

Server Configuration

// `src/index.ts`
const tools = getToolDefinitions();

const server = new Server({
  name: "mcp-server",
  version: "0.1.0"
}, {
  capabilities: {
    tools: getToolDefinitions()
  }
});

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: tools
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  try {
    const handler = getToolHandler(request.params.name);
    if (!handler) {
      return toolController.getUnknownToolResponse(request.params.name);
    }
    return await handler(request.params.arguments);
  } catch (error) {
    return toolController.getErrorResponse(error);
  }
});

Integration with Cursor

1. Open the settings.
2. Navigate to the feature options.
3. Scroll to the MCP server section.
4. Click "Add New MCP Server".
5. Enter the server name.
6. Select the type as command.
7. Fill in the server address, for example, node <Absolute Project Path>/build/index.js when using locally.

After completing the above steps, the server status will be displayed in green, and all registered tools will be listed.