simple-mcp-server

simple-mcp-server

0
developer_toolscustomer_data_platforms

The project is a Model Context Protocol (MCP) server that facilitates user data management. It features TypeScript implementation, user data retrieval tools, and supports ES Modules. It is designed for easy development and extension with built-in compilation tools.

A simple MCP Server

A Model Context Protocol (MCP) server implementation that provides tools for user data management.

MCP Server Logo

Features

  • User data retrieval tools
  • TypeScript implementation
  • ES Modules support
  • Built-in TypeScript compilation

Prerequisites

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

Installation

  1. Clone the repository:
git clone https://github.com/fujahgabriel/simple-mcp-server.git
cd simple-mcp-server
  1. Install dependencies:
npm install

Development

Building the Project

To build the TypeScript files:

npm run build

This will:

  • Compile TypeScript files to JavaScript
  • Output files to the build directory
  • Set proper permissions on the output files

Development Mode

To watch for changes and automatically rebuild:

npm run watch

Using the MCP Inspector

To inspect and test your MCP server tools:

  1. First build the project:
npm run build
  1. Start the MCP Inspector:
npm run inspector
  1. The inspector will be available at http://localhost:5173

MCP Configuration

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

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

Make sure to:

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

Available Tools

get_users

Retrieves a list of all users.

get_user

Retrieves a specific user by name.

Parameters:

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

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