Roc MCP Testbed

🚀 Roc Model-Context-Protocol Server

This is a simple proof-of-concept for the Roc MCP server, quickly put together in a few hours. Take it as it is.

🚀 Quick Start

✨ Features

• It's a simple proof - of - concept for the Roc MCP server.
• Communicates over Stdin/Stdout, with additional info logged to Stderr.
• Uses JSON - RPC and requires an initialization handshake before handling tool calls.

📦 Installation

No specific installation steps are provided in the original document.

💻 Usage Examples

Basic Usage

Configuring in Claude desktop

Go to Claude->Settings->Developer->Edit Config, and add the MCP server like so:

{
  "mcpServers": {
    "current_datetime": {
      "command": "/absolute/path/to/your/roc/",
      "args": [
        "/absolute/path/to/roc-mcp-testbed/src/main.roc"
      ]
    }
  }
}

Advanced Usage

Manual Test Messages

The MCP server communicates over Stdin/Stdout, with additional info logged to Stderr. You can manually test the behavior of the server by running the binary from your cli and sending messages over Stdin. Model Context Protocol uses JSON - RPC, and requires an initialization handshake before the server will handle tool calls.

Below are some messages to get you started:

1) Initialization

{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "manual-test", "version": "1.0.0"}}}

2) Confirm the handshake

{"jsonrpc": "2.0", "method": "notifications/initialized"}

3) Get the tool list

{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}

4) Call a tool

{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "local_datetime", "arguments": {}}}

📚 Documentation

The above content provides basic information about configuring and testing the Roc MCP server.

🔧 Technical Details

The MCP server uses JSON - RPC for communication and requires an initialization handshake before handling tool calls. It communicates over Stdin/Stdout, with additional info logged to Stderr.

📄 License

No license information is provided in the original document.