mcpField
A
A simple MCP Server

A simple MCP Server

Local
github.com/fujahgabrielDeveloper Tools1Updated 81w ago
Repository

About A simple MCP Server

A simple MCP Server is a TypeScript MCP server for user data lookup, offering tools to list users or retrieve one by name. It supports ES Modules and includes a TypeScript build workflow.

Key features

  1. 01List all users
  2. 02Retrieve a user by name
  3. 03TypeScript implementation
  4. 04ES Modules support
  5. 05Built-in TypeScript compilation

Use cases

  1. 01Query a user list through MCP
  2. 02Find a specific user by name
  3. 03Build and test a TypeScript MCP server

MCP support

The server exposes get_users and get_user tools to MCP clients for retrieving user data.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.