User Info

Provides a user management MCP server that serves user data from JSON and exposes tools to list, search, and add users.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "huseyindol-mcpprojectscaffold": {
      "command": "node",
      "args": [
        "dist/server.js"
      ]
    }
  }
}

You run a dedicated MCP Server that serves user information from a JSON data source and exposes a set of tools to manage and query users. It follows Context7 MCP best practices with a clean, layered architecture, making it straightforward to integrate with MCP clients and test tools interactively.

How to use

You connect to this MCP Server from an MCP client to perform common user management tasks. You can fetch all users, retrieve a user by ID, search by name, email, or phone, and add new users with validation and duplicate checks. Use the client’s tool-call interface to invoke the named tools, and read the responses to confirm results. Start with listing all users to understand the available data, then drill down with specific lookups or add new entries as needed.

How to install

# Prerequisites
- Install Node.js v18+ (and npm)
- Ensure you have a working MCP client setup that can reach the MCP server

# 1. Install dependencies
npm install

# 2. Build the TypeScript project
npm run server:build

# 3. Run in development mode
npm run server:dev

# 4. Start the MCP Inspector for interactive testing
npm run server:inspect

Additional configuration and usage notes

This MCP server exposes a small set of user-related tools. You can run them from your MCP client by invoking the corresponding tool names. The server uses a layered architecture with Controllers handling MCP tool calls, a Service layer for business rules and validations, and a Repository layer for JSON data access.

Key data structure you will interact with is the User object, which includes an auto-incremented id, a name, a unique email, and a phone number. All inputs are validated at runtime, with error messages returned for invalid or duplicate data.

Security and validation considerations

Input data is validated using schema-based checks at runtime. Email format is strictly enforced, name length is constrained, and phone numbers are checked for reasonable length. Duplicate emails are prevented during user creation.

MCP tools overview

The server provides six MCP tools for user management. You can call these tools from your MCP client to perform specific operations.

Troubleshooting

If you encounter issues starting the server, verify that dependencies are installed, perform a clean rebuild, and ensure the correct npm scripts are used for development or build tasks. If the MCP Inspector cannot connect, confirm that the server is running on the expected port and that the client is configured to reach it.

Available tools

get_all_users

Retrieve a list of all users with their basic details.

get_user_by_id

Fetch a single user by their unique ID.

search_users_by_name

Search for users by name with partial matching.

search_users_by_email

Search for users by email address.

search_users_by_phone

Search for users by phone number.

add_user

Add a new user with validation and duplicate email prevention.