humanmcp MCP Server

What is humanmcp?

humanmcp is a joke MCP server that requires a human to manually process all requests and responses. Instead of automating tools, the user reads incoming JSON-RPC requests from in.txt and writes the corresponding responses to out.txt. It is intended as a humorous parody of automated MCP servers.

How to use humanmcp?

1. Download the server binary from the Releases page.
2. Add the server to your MCP host settings (e.g., VSCode) with the command pointing to the binary.
3. Monitor in.txt for incoming requests using tail -f in.txt.
4. Manually craft and write the correct JSON-RPC response to out.txt using echo '...' > out.txt or similar.

Key features of humanmcp

• 100% manual operation – no automation involved.
• Reads requests from in.txt and writes responses to out.txt.
• Works with any MCP host that supports external servers.
• Lightweight binary distributed via GitHub Releases.
• Demonstrates the underlying MCP protocol in a transparent way.

Use cases of humanmcp

• Learning the MCP protocol by manually handling requests and responses.
• Testing MCP client behaviour with a predictable, human‑controlled server.
• Fun / educational demonstration of how MCP servers communicate.
• Exploring the structure of JSON-RPC messages in an MCP context.