oeis -rs

This MCP server provides a Rust-based OEIS implementation that exposes an MCP-compatible API over HTTP. It is intended to be used as a backend for clients that want to query or interact with OEIS data through the MCP protocol. The recommended way to run it is via Docker, which maps port 8000 on the host to port 8000 in the container so clients can reach the /mcp endpoint. After starting the server, you can configure your MCP client (for example Claude or any MCP-enabled tool) to point at http://localhost:8000/mcp and begin issuing MCP commands.

Once running, clients can add and interact with the OEIS MCP service using standard MCP actions (e.g., adding the transport http and a base URL). The README example shows how Claude would register the service: claude mcp add --transport http oeis http://localhost:8000/mcp

If you prefer building from source, you can run the Rust application directly inside a development environment, but for production usage the Docker image is the recommended path.

Prerequisites:

• Docker (recommended) or Rust toolchain for building from source
• If using Docker: Docker must be installed and running

Installation options:

Option A: Run with Docker (recommended)

1. Pull and run the image (port 8000 will be exposed on the host): docker run -p 8000:8000 --name oeis-mcp-server ghcr.io/23prime/oeis-mcp-server:latest

2. Verify the server is running by curling the MCP endpoint: curl http://localhost:8000/mcp

Option B: Build from source (Rust)

1. Ensure Rust is installed (rustup).
2. Clone the repository and navigate to the project directory.
3. Build the binary (cargo build --release).
4. Run the binary (e.g., ./target/release/oeis-mcp-server) and ensure it listens on port 8000 or the configured port.
5. Access the MCP endpoint at http://localhost:8000/mcp

Note: If you plan to run tests or development tasks, you can use the provided Mise commands referenced in the repository’s development section.

Tips and notes:

• The recommended deployment method is via Docker as shown in the instructions, which simplifies port mapping and image management.
• The default port is 8000; ensure your firewall allows inbound connections on that port if you expose the service publicly.
• When using Docker, you can customize the container name with --name (as shown) and reuse the container for updates by rebuilding the image and restarting the container.
• For development with Rust, the project uses Mise for managing tasks such as setup, dev, and tests. The typical commands are mise run setup, mise run rs-dev, and mise run test-check.
• If you need to change the host port, adjust the -p mapping in the Docker run command, e.g., -p 8080:8000 to expose port 8080 on the host.
• If your MCP client requires authentication or specific headers, add those at the client side; the server exposes the /mcp endpoint for MCP communications.