mcp

This MCP server is a lightweight Java-based implementation of the Model Context Protocol (MCP) that exposes a server over HTTP with both JSON-RPC (POST) and Server-Sent Events (GET) transports. On startup, the server binds to port 8080 and serves MCP requests at /mcp. It supports loading tools dynamically from JSON configurations placed in the tools/ directory, including built-in tools like a calculator, web search, and simple file operations. To interact with the server, send JSON-RPC payloads via POST to http://127.0.0.1:8080/mcp, or subscribe to server-sent events with a GET request to the same path to receive continuous tool updates or results.

Prerequisites:

• Java 17 or higher installed on your system
• Maven 3.6+ installed

1. Install Java and Maven if they are not already installed.
2. Clone the repository containing the MCP server code.
3. Build the project: mvn clean package This creates a runnable jar at target/mcp-server-1.0-jar-with-dependencies.jar.
4. Run the server: java -jar target/mcp-server-1.0-jar-with-dependencies.jar
5. Verify the server is running by visiting http://localhost:8080/mcp or by querying via JSON-RPC at that endpoint.

Notes and tips:

• The server runs by default on http://0.0.0.0:8080, making it accessible on all network interfaces. Use localhost (127.0.0.1) for local testing.
• Tools are loaded from JSON files placed under the tools/ directory. Each tool defines a name, description, type, command to run, and an input schema. You can add or modify tools to extend functionality.
• Ensure the command field in tool configurations is valid on the host system where the server runs. The server executes the configured commands as child processes.
• If you modify Tools or configuration files, restart the server to reload the tool configurations.
• If you encounter port conflicts, you can customize the binding port in the server configuration if supported, or run the server on a different port.
• The built-in tools include calculator, web search, and file operations, among others, enabling quick tasks without external clients.