Create MCP Server

🚀 @m Server Port

This is a server project built with TypeScript and FastMCP, aiming to implement the Model Context Protocol (MCP). The server supports multiple functional modules and can be tested and inspected via CLI tools.

🚀 Quick Start

Install Dependencies

npm install fastmcp @types/zod

Start the Server

npm run dev

✨ Features

1. Implement the MCP protocol using FastMCP.
2. Support standard CLI tools (fastmcp and fastmcp-inspect) for testing and inspection.
3. Provide flexible configuration options, allowing customization of server behavior through environment variables.

📦 Installation

Initialize the Project

npx @m/server init

Or use npm:

npm create @m/server

💻 Usage Examples

FastMCP CLI Tools

# Start the test server using fastmcp
npx fastmcp dev server.js

# Check the server status using fastmcp-inspect
npx fastmcp inspect server.ts

Configuration File Example

Create a server.ts file in the project root directory:

import { FastMCP } from "fastmcp";

const server = new FastMCP();

// Add a custom tool
server.addTool({
  name: "hello_world",
  description: "A simple hello world tool",
  parameters: z.object({
    name: z.string().describe("Name to greet")
  }),
  execute: async (params) => {
    return `Hello, ${params.name}!`;
  }
});

// Add a custom resource template
server.addResourceTemplate({
  uriTemplate: "example://{id}",
  name: "Example Resource",
  mimeType: "text/plain",
  arguments: [
    {
      name: "id",
      description: "Resource ID",
      required: true,
    },
  ],
  async load({ id }) {
    return {
      text: `This is an example resource with ID: ${id}`
    };
  }
});

// Add a custom prompt
server.addPrompt({
  name: "greeting",
  description: "A simple greeting prompt",
  arguments: [
    {
      name: "name",
      description: "Name to greet",
      required: true,
    },
  ],
  load: async ({ name }) => {
    return `Hello, ${name}! How can I help you today?`;
  }
});

// Start the server
server.start();

Environment Variable Configuration

# Change the HTTP port (default is 3001)
PORT=8080 npm run start

# Change the binding address (default is 0.0.0.0)
HOST=127.0.0.1 npm run start

📚 Documentation

• FastMCP Official Documentation: FastMCP GitHub Repository
• Model Context Protocol (MCP): MCP Official Documentation

📄 License

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