Humanmcp

🚀 HumanMCP - A Joke MCP Server Project

This is a joke project about an MCP server, aiming to bring some fun and unique experience to the MCP-related development.

🚀 Quick Start

✨ Features

• Manual Operation: The MCP server is 100% manually operated, offering a distinct interaction mode.

📦 Installation

1. Download the server binary from Releases.
2. Add the server to the MCP host settings.

// Example: VSCode settings
"mcp": {
  "inputs": [],
  "servers": {
    "human-mcp": {
      "command": "path/to/humanmcp/executable",
      "args": [
      ],
      "env": {}
    }
  }
}

💻 Usage Examples

Basic Usage

This MCP server is 100% manually operated. Good luck!

• Read requests from in.txt.
• Write responses to out.txt.

# Monitor client requests
$ tail -f in.txt
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"roots":{"listChanged":true}},"clientInfo":{"name":"Visual Studio Code","version":"1.99.2"}}}
{"method":"notifications/initialized","jsonrpc":"2.0"}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get-japan-forecast","arguments":{"location":"Tokyo"}}}

# Send responses back to the client
$ echo '{"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"humanmcp","version":"1.0.0","capabilities":{"resources":{},"tools":{}}}},"jsonrpc":"2.0","id":1}' > out.txt
$ echo '{"result":{"tools":[{"name":"get-japan-forecast","description":"Get weather forecast","inputSchema":{"type":"object","properties":{"location":{"type":"string","description":"location name"}},"required":["location"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}]},"jsonrpc":"2.0","id":2}' > out.txt
$ echo '{"result":{"content":[{"type":"text","text":"sunny"}]},"jsonrpc":"2.0","id":3}' > out.txt

🔍 Architecture Diagram

(Of course, this is a joke project :sweat_smile: )