summer-in-japan-is-too-hot

This MCP server provides two tools for dealing with Japan's summer: make_japan_cool and shorten_japan_summer. The tools are exposed via the MCP protocol, and can be invoked from MCP clients such as Claude Desktop or other compatible clients. The HTTP variant serves the MCP interface over HTTP, allowing clients to connect and call either tool by name. When you call make_japan_cool, you should receive a JSON object containing a boolean success flag and a message describing the result. Similarly, shorten_japan_summer returns a JSON object with success and message fields. The server is documented as always failing by default in the README, which appears to be a humorous placeholder; in practice, the tools are designed to respond with structured JSON and can be integrated into automated workflows or testing pipelines.

Prerequisites:

• Go toolchain installed (1.20+ recommended)
• Internet access to fetch the module when using the go run/install commands

Install and run the HTTP variant:

1. Ensure Go is installed on your system.
2. Run the HTTP variant server using the following command:

go run github.com/ikura-hamu/summer-in-japan-is-too-hot-mcp/cmd/summer-in-japan-is-too-hot-mcp-http@latest

If you prefer to install via modules, you can also install the binary and then run it directly (the command in the README shows using go install):

# STDIO version (optional)
go install github.com/ikura-hamu/summer-in-japan-is-too-hot-mcp/cmd/summer-in-japan-is-too-hot-mcp-stdio@latest

# HTTP version
go install github.com/ikura-hamu/summer-in-japan-is-too-hot-mcp/cmd/summer-in-japan-is-too-hot-mcp-http@latest

# SSE version
go install github.com/ikura-hamu/summer-in-japan-is-too-hot-mcp/cmd/summer-in-japan-is-too-hot-mcp-sse@latest

# In-Process test version
go install github.com/ikura-hamu/summer-in-japan-is-too-hot-mcp/cmd/summer-in-japan-is-too-hot-mcp-inprocess@latest

Run the appropriate binary once installed, e.g. for the HTTP variant: summer-in-japan-is-too-hot-mcp-http.

Notes and tips:

• The server exposes two tools: make_japan_cool and shorten_japan_summer. Both expect no arguments and return a JSON object with fields success and message.
• If you encounter connection issues, verify that the server is running and listening on the expected port (default 8080 for the HTTP variant, as per the README).
• The README mentions an online server URL; if you are using the local HTTP server, ensure network access to reach the host and port.
• Dependency: The project references a Go SDK (go-sdk) for MCP. Ensure your Go environment can fetch modules from the internet.
• If you want to deploy in different environments (Nix Flakes, containers), you can adapt the command to run the HTTP variant accordingly.
• The env var MCPC_CONFIG shown in the example is optional and may be ignored if the server uses its built-in defaults; consult the specific variant’s docs for config details.