Mcpserver

Name: Mcpserver
Author: mrwylan

@mrwylan

Repository

About Mcpserver

a simple mcp server exposing a list of colors

#mcpserver #color-list #java-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "localmcp": {
      "type": "command",
      "command": "D:\\jdks\\jdk-21+35\\bin\\java.exe",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "D:\\ws\\ws_mcp_server\\my_mcp_server\\target\\mymcp-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mcpserver?

Mcpserver is a simple demo MCP (Model Context Protocol) server built with Spring Boot. It exposes a list of color name and hex value pairs, allowing users to list all colors, get one, or add a color entry. The server is designed for learning and testing MCP integrations, such as with Claude Desktop.

How to use Mcpserver?

Build the project with mvn clean package, then run java -jar target/mymcp-0.1.0-SNAPSHOT.jar. Connect via SSE transport by configuring Claude Desktop (with Developer Mode) using the provided JSON snippet, replacing the URL/port if the server port is changed. Verify the SSE endpoint is registered at /actuator/mappings after startup.

Key features of Mcpserver

Exposes a list of color names and hex values.
Supports list all, get one, and add one color operations.
Uses SSE (Server-Sent Events) transport.
Built with Spring Boot and Maven.
Includes an actuator endpoint to verify registered mappings.
Can be inspected using the MCP Inspector tool.

Use cases of Mcpserver

Learning how to build and run an MCP server with Spring Boot.
Testing MCP client integration (e.g., Claude Desktop) with a simple data set.
Demonstrating basic CRUD operations over the Model Context Protocol.
Experimenting with SSE transport in MCP.

FAQ from Mcpserver

What transport does Mcpserver use?

Mcpserver uses SSE (Server-Sent Events) transport, as shown in the Claude Desktop configuration with "type": "sse".

How do I configure Claude Desktop to use Mcpserver?

In your Claude Desktop config (with Developer Mode enabled), add an entry like "localmcp": { "type": "sse", "url": "http://localhost:8080/sse" } and adjust the URL/port if needed.