A Simple MCP Server

🚀 A Simple MCP Server

This is an implementation of a Model Context Protocol (MCP) server that provides user data management tools.

🚀 Quick Start

This MCP server offers user data management tools. It's implemented in TypeScript, supports ES modules, and has built - in TypeScript compilation.

✨ Features

• User data retrieval tools
• Implemented in TypeScript
• Support for ES modules
• Built - in TypeScript compilation

📦 Installation

Prerequisites

• Node.js (v20 or higher)
• npm (v9 or higher)

Steps

1. Clone the repository:

git clone https://github.com/fujahgabriel/simple-mcp-server.git
cd simple-mcp-server

2. Install dependencies:

npm install

💻 Usage Examples

Development

Building the Project

To compile TypeScript files:

npm run build

This will:

• Compile TypeScript files to JavaScript
• Output to the build directory
• Set the correct permissions for the output files

Development Mode

To watch for changes and automatically rebuild:

npm run watch

Using MCP Inspector

To check and test your MCP server tools:

1. First, build the project:

npm run build

2. Start the MCP Inspector:

npm run inspector

3. The inspector will be available at http://localhost:5173

MCP Configuration

To use this MCP server with Cursor, you need to configure it in the MCP settings. Add the following configuration to your ~/.cursor/mcp.json:

{
  "my-mcp-server": {
    "math": {
      "command": "node",
      "args": ["build/index.js"]
    }
  }
}

Please ensure:

1. Build the project first using npm run build
2. Use the built JavaScript file with the correct path
3. Restart Cursor after updating the configuration

Available Tools

get_users

Retrieve a list of all users.

get_user

Retrieve a specific user by name.

Parameters:

• user: string - The name of the user to retrieve

📚 Documentation

Project Structure

mcp-server/
├── build/           # Compiled JavaScript files
├── index.ts         # Main server implementation
├── package.json     # Project dependencies and scripts
└── tsconfig.json    # TypeScript configuration

Dependencies

• @modelcontextprotocol/sdk: MCP SDK for server implementation
• dotenv: Environment variable management
• typescript: TypeScript compiler
• zod: Runtime type validation

📄 License

MIT