Happy slice of mcp pizzaMCP.pizza

openrpc-mpc-server

MCP.Pizza Chef: shanejonas

The openrpc-mpc-server is a Model Context Protocol (MCP) server that provides JSON-RPC functionality through the OpenRPC specification. It allows clients to discover available JSON-RPC methods on a server and call arbitrary JSON-RPC methods by specifying the server URL, method name, and parameters. This server facilitates structured, real-time interaction between LLMs and JSON-RPC APIs, enabling dynamic method invocation and discovery. It supports development workflows with easy installation, building, and auto-rebuild features, and integrates smoothly with MCP hosts like Claude Desktop. The server leverages OpenRPC's rpc.discover specification to list all methods on a given JSON-RPC server, making it a powerful tool for developers building AI-enhanced workflows that require JSON-RPC API access.

Use This MCP server To

Discover JSON-RPC methods on remote servers Invoke arbitrary JSON-RPC methods with parameters Integrate JSON-RPC APIs into AI workflows Enable LLMs to interact with JSON-RPC services Automate JSON-RPC API testing and exploration Support dynamic JSON-RPC method invocation Facilitate real-time JSON-RPC communication in MCP Bridge OpenRPC APIs with MCP clients

README

OpenRPC MCP Server

A Model Context Protocol (MCP) server that provides JSON-RPC functionality through OpenRPC.

Screen.Recording.2024-12-02.at.8.59.57.PM.mov

Features

Tools

  • rpc_call - Call arbitrary JSON-RPC methods
    • Specify server URL, method name, and parameters
    • Returns JSON-formatted results
  • rpc_discover - Discover available JSON-RPC methods
    • Uses OpenRPC's rpc.discover specification
    • Lists all methods on a given server

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "openrpc": {
      "command": "npx",
      "args": ["-y", "openrpc-mcp-server"]
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

openrpc-mpc-server FAQ

How do I install the openrpc-mpc-server?
Install dependencies with 'npm install', then build using 'npm run build'. For development, use 'npm run watch' for auto-rebuild.
How does rpc_discover work?
It uses OpenRPC's rpc.discover specification to list all available JSON-RPC methods on a specified server.
Can I call any JSON-RPC method with this server?
Yes, using the rpc_call tool, you specify the server URL, method name, and parameters to invoke any JSON-RPC method.
How do I integrate openrpc-mpc-server with Claude Desktop?
Add the server configuration to Claude Desktop's config file on MacOS or Windows as described in the installation instructions.
Is openrpc-mpc-server compatible with multiple LLM providers?
Yes, it works with MCP clients that can connect to models from OpenAI, Anthropic Claude, and Google Gemini, among others.
What programming environment is required?
Node.js environment is required to install and run the server using npm commands.
Does openrpc-mpc-server support real-time method discovery?
Yes, it dynamically discovers JSON-RPC methods on servers at runtime using OpenRPC standards.
Can I extend or customize the server?
Yes, since it is open source, you can modify the codebase to add features or adapt it to your needs.