MCP Test Server

You will run a real MCP server that speaks the Model Context Protocol and can be used with Warp for advanced AI tooling. It also includes a traditional HTTP server for development and manual testing. This setup exposes a few built-in tools to help you manage users and tasks from an LLM or other client.

How to use

To interact with the MCP server, start the local MCP process and connect your MCP client or Warp to the configured endpoints. You will have two available endpoints: a traditional HTTP REST server for development and a real MCP server that communicates via JSON-RPC over stdio. Use the HTTP server for quick testing in a browser, and use the MCP server when integrating with Warp or other MCP clients.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Install project dependencies.

npm install

Start the HTTP server for development and testing.

npm start

Start the MCP server to enable Warp integration.

npm run mcp

Test the HTTP server endpoints.

npm test

Warp configuration example for using the MCP server (STDIO). The MCP server runs locally as a stdio process and Warp connects to it.

{
  "mcpServers": {
    "mcp_test_server": {
      "command": "node",
      "args": ["mcp-server.js"],
      "working_directory": "C:\\Users\\yvanf\\Documents\\MCP-test"
    }
  }
}

Additional configuration and notes

The project provides two server types you can run locally. The HTTP Server is a traditional REST API that you can open in a browser at http://localhost:3000. It is not compatible with Warp MCP. The MCP Server is a true MCP server that implements JSON-RPC over stdio and exposes tooling for LLMs. It is not accessible via a browser and is intended for integration with Warp and other MCP clients.

Warp configuration shows how to connect to the MCP server as a local stdio process. Use the command and arguments below to run the MCP server and point Warp to it.

{
  "mcpServers": {
    "mcp_test_server": {
      "command": "node",
      "args": ["mcp-server.js"],
      "working_directory": "C:\\Users\\yvanf\\Documents\\MCP-test"
    }
  }
}

Available tools that you can call through the MCP interface include: get_users to list users, get_user to obtain a user by ID, create_user to create a new user, get_tasks to list tasks, create_task to create a new task, and search to look up users and tasks.

Available tools

get_users

List all users in the system.

get_user

Retrieve a specific user by their ID.

create_user

Create a new user with the provided data.

get_tasks

List all tasks in the system.

create_task

Create a new task with the given details.

search

Search across users and tasks using provided query terms.