Party Time MCP Server

What is Party Time MCP Server?

Party Time MCP Server is a simple MCP server that registers a single tool called get-time and always responds with "It's Party Time" when the tool is called. It implements the Machine Conversation Protocol (MCP) directly, handling JSON‑RPC messages. Built in Elixir as an escript, it is designed for integration with Claude Desktop.

How to use Party Time MCP Server?

Build the executable with mix deps.get and mix escript.build, then make it executable with chmod +x ./party_time_mcp. Configure Claude Desktop by adding a mcpServers entry in claude_desktop_config.json pointing to the executable. Restart Claude Desktop and ask "What time is it?" to invoke the get-time tool.

Key features of Party Time MCP Server?

• Single tool get-time that returns "It's Party Time"
• Implements MCP protocol messages: initialize, tools/list, tools/call, notifications/initialized
• Built as a standalone Elixir escript with no runtime dependencies
• Outputs only clean JSON to stdout (logs sent to stderr)
• Robust error handling for invalid requests and unknown methods
• Supports manual testing via stdin with JSON‑RPC messages

Use cases of Party Time MCP Server?

• Demonstrating a minimal MCP server implementation
• Testing Claude Desktop’s tool discovery and execution flow
• Learning the MCP protocol with a simple, focused example
• Providing a fun, predictable response to time‑related queries

FAQ from Party Time MCP Server

What does the server do when the get-time tool is called?

It always responds with the string "It's Party Time", regardless of the current time.

How do I fix JSON parsing errors in Claude Desktop?

Ensure you are using the latest version of the server. The current version sends log messages to stderr to keep stdout clean, preventing JSON‑RPC parsing issues.

What should I do if I see a Mix.env() error at runtime?

Rebuild the executable with mix escript.build. The error occurs when the executable was built with code that calls Mix.env/0 at runtime, which is unavailable in an escript.

How can I test the server manually before configuring Claude Desktop?

Run ./party_time_mcp and pipe JSON‑RPC messages to it, for example: echo '{"jsonrpc":"2.0","id":"test-1","method":"tools/list"}' | ./party_time_mcp.

What dependencies are required to run the server?

No runtime dependencies; the compiled escript runs standalone. For building, Elixir and Mix are required.