MCP Server Java

A Model Context Protocol (MCP) server implementation in Java, demonstrating the core MCP features including tools, resources, and prompts.

Features

This MCP server provides:

Tools

• add: Add two numbers together
• multiply: Multiply two numbers
• get_current_time: Get the current server time
• greet: Greet a person by name
• ai_chat: Send prompts to Azure AI Foundry agent and get AI-powered responses

Resources

• server-info: Information about the MCP server
• documentation: Server documentation and usage examples

Prompts

• math_helper: Get help with mathematical calculations
• current_time: Get the current time

Prerequisites

• Java 17 or higher
• Maven 3.6+

Building the Server

Build the project using Maven:

mvn clean package

This will create an executable JAR file: target/mcp-server-java-1.0.0.jar

Running the Server

Run the server directly:

Export the Azure OpenAI API Key in Powershell : $env:AZURE_OPENAI_API_KEY="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
Check that the environment variable is set c:>echo $env:AZURE_OPENAI_API_KEY

🚀 Usage

Start HTTP Server:

java -jar target/mcp-server-java-1.0.0.jar --http

java -jar target/mcp-server-java-1.0.0.jar 

Run Java Server:

Working Solution Step 1: Start the HTTP Server (in one terminal) java -jar target/mcp-server-java-1.0.0.jar --http (need http server to be running first)

Run Java Client:

Step 2: Run the Java Client (in another terminal) mvn exec:java "-Dexec.mainClass=com.example.mcp.client.McpJavaClient"

NPX Node Package eXecute

nxp command to test over web page

npx @modelcontextprotocol/inspector java -jar target/mcp-server-java-1.0.0.jar
create a npx test harness to check out and test the functionality !

Testing out the tools :

HTTP JSON API Server started successfully!
API Endpoints:
http://localhost:8080/tools - List available tools
http://localhost:8080/tools/add - Add two numbers
http://localhost:8080/tools/multiply - Multiply two numbers
http://localhost:8080/tools/time - Get current time
http://localhost:8080/tools/greet - Greet by name
http://localhost:8080/tools/ai_chat - Chat with AI agent

List all tools

curl -X GET http://localhost:8080/tools

Add two numbers

curl -X POST http://localhost:8080/tools/add -H "Content-Type: application/json" -d '{"a":"7","b":"51"}'

Multiply two numbers

curl -X POST http://localhost:8080/tools/multiply -H "Content-Type: application/json" -d '{"x":"7","y":"70"}'

Get current time

curl -X GET http://localhost:8080/tools/time

Greet someone

curl -X POST http://localhost:8080/tools/greet -H "Content-Type: application/json" -d '{"name":"Steve"}'

Chat with AI Agent

curl -X POST http://localhost:8080/tools/ai_chat -H "Content-Type: application/json" -d '{"prompt": "What is Azure AI Foundry?"}'

curl -X POST http://localhost:8080/tools/ai_chat -H "Content-Type: application/json" -d '{"prompt": "Hello"}'

Chat with AI Agent with Optional Parameters

curl -X POST http://localhost:8080/tools/ai_chat -H "Content-Type: application/json" -d '{"prompt": "Explain Model Context Protocol in simple terms", "max_tokens": 200, "temperature": 0.5 }'

curl -X POST http://localhost:8080/tools/ai_chat -H "Content-Type: application/json" -d '{"prompt": "Write a haiku about coding", "max_tokens": 200, "temperature": 0.5 }'

🚀 Usage

Start HTTP Server:

java -jar target/mcp-server-java-1.0.0.jar --http

Start STDIO Server:

java -jar target/mcp-server-java-1.0.0.jar

git hub integration

in command prompt in git directory:
git status
On branch main
nothing to commit, working tree clean
PS C:\Users\stethompson\Microsoft\MCP_Server_Java> git init
Rei

... View full README on GitHub