opal-mcp-adapter

# MCP-Opal Adapter A bidirectional adapter service that converts between MCP (Model Context Protocol) tools and Opal tools using the official Opal Tools SDK with automatic MCP discovery. ## Quick start Install the opal-mcp-adapter cli ```bash pip install opal-mcp-adapter ``` Start the mcp adapter with an mcp config ```bash opal-mcp-adapter --port 8030 --config mcp.json ``` You can now see the MCP tools registered as Opal tools at `http://localhost:8030/discovery` and use them inside Opal ## Usage ### Using a config file The adapter supports standard `mcp.json` files as a config argument A sample mcp.json ```json { "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Desktop", "/Users/username/Downloads" ] } } } ``` In order to run these mcp tools through the adapter, it needs to be pointed towards the config file ```bash opal-mcp-adapter --config mcp.json ``` This will register the servers defined in the config file, and launch a compatible opal tools server at "http://localhost:8000" (with the default host and port) See more mcp.json examples here https://modelcontextprotocol.io/quickstart/user ### CLI Usage Examples The `opal-mcp-adapter` command supports various options for customizing the server behavior: ```bash # Start server on 0.0.0.0:8000 (default) opal-mcp-adapter # Start server on localhost:8000 opal-mcp-adapter --host localhost # Start server on 0.0.0.0:9000 opal-mcp-adapter --port 9000 # Start server on 127.0.0.1:8080 opal-mcp-adapter --host 127.0.0.1 --port 8080 # Start server with MCP configuration file opal-mcp-adapter --config mcp.json # Start server on custom port with config opal-mcp-adapter --port 8030 --config mcp.json # Display version information opal-mcp-adapter --version ``` #### Command Line Options - `--host`: Host address to bind the server to (default: 0.0.0.0) - `--port`: Por…