Model Context Protocol POC
This project aims to play with MCP and Spring AI.
This is a Maven Multi Module project
MCP Server
STDIO based communication implementation. Based on
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchThe server exposes two tools:
get_city_geolocation: get latitude and longitude from a city nameget_weather_forecast: retrieve weather forecast for the given latitude and longitude. Default is 7 daysmvn clean package
npx @modelcontextprotocol/inspector
http://localhost:6274 and set:
STDIOjava-jar /absolute/path/to/mcp-server-1.0.0-SNAPSHOT.jarNow you can explore the MPC server
Locate the file claude_desktop_config.json:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAdd a new entry in the mcpServers object:
{
"mcpServers": {
"spring-ai-mcp-weather": {
"command": "java",
"args": [
"-jar",
"/absolute/path/to/mcp-server-1.0.0-SNAPSHOT.jar"
]
}
}
}
Try to ask Claude "what's the forecast for tomorrow in [your city name]?". Claude will be capable of understand that need to retrieve geo info to give you the answer (using both tools)
Please note that the prompt is bound to Italy cities
The client is basically a command line chat based on OpenAI: thanks to Spring AI and MCP integration, the client connects to the MCP servers defined in claude_desktop_config.json
and create the clients automatically for each configured server.
Please note that the
claude_desktop_config.jsoncontains absolute paths because is using STDIO communication: this type of communication requires the client to start the server, so the project must me built first!mvn package
The client requires the OpenAI key, provided as env variable
OPENAI_API_KEY.
The client starts and list the available tools, then is ready to chat.
POC project for testing Spring AI working with MCP server and client
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
MCP Poc runs locally over stdio.
Last checked 2026-10-28. POC project for testing Spring AI working with MCP server and client