Sandbox
@reshaprio/reshapr

MCP server for REST, GraphQL, and gRPC APIs

reShapr sits between your APIs and your agent, turning existing REST, GraphQL, and gRPC endpoints into MCP tools. It adds a control plane, a proxy, and a CLI so you can run it locally, import APIs, and manage access without coding a custom adapter.

121 stars27 forksJavaUpdated 7d ago
Who it's for

Builders who want Claude Code, Codex, Cursor, or another MCP client to call existing services through one setup.

What it delivers

You can give your agent lean, usable API access instead of pasting huge JSON responses and custom glue code.

What it does

API to MCP conversion

Transforms REST, GraphQL, and gRPC services into MCP tools the agent can call.

Context control

Filters and trims payloads before they reach the model to reduce token waste.

Control plane and proxy

Separates administration from runtime access so imported APIs can be managed and served.

CLI import and run flow

Lets you start a local stack, log in, and import an OpenAPI spec from the terminal.

Web UI

Provides a browser interface for exploring and managing the platform.

How to get it

  1. 1Run
    npm install -g @reshapr/reshapr-cli
  2. 2Assuming you have Docker installed, you can run the platform locally with the following…
    reshapr run
  3. 3You should see a message like this
    ℹ️  Resolved 'latest' to release '0.2.2'.
    ℹ️  Downloading compose file from https://raw.githubusercontent.com/reshaprio/reshapr/refs/tags/0.2.2/install/docker-compose-all-in-one.yml...
    ✅ Compose file saved to /Users/<you>/.reshapr/docker-compose-0.2.2.yml
    ℹ️  Starting Reshapr containers (release: 0.2.2)...
    ✅ Reshapr containers started successfully.
  4. 4Connect to the control plane at http://localhost:5555 with default credentials…
    reshapr login -s http://localhost:5555 -u admin -p password
  5. 5Import an OpenAPI file
    reshapr import -u https://raw.githubusercontent.com/open-meteo/open-meteo/refs/heads/main/openapi.yml \
      --backendEndpoint https://api.open-meteo.com

README

GitHub Workflow Status Container Version NPM License Project Chat GitHub stars

Welcome to reShapr 🚀

Website | About | Docs | Blog | Community


✨ What is reShapr?

reShapr is the open source, no-code MCP Server for AI-Native API Access. It bridges the gap between traditional REST/GraphQL/gRPC services and LLMs by transforming complex services into discoverable, optimized MCP tools.

reShapr Demo - Click to get started
✨ Transform any API into lean LLM contexts in seconds.

[!IMPORTANT] To get involved with our community, please familiarize yourself with the project's Code of Conduct.

🧠 Solving the "Context Window" Problem

One of the biggest hurdles in building AI agents is Context Overload. Sending massive JSON responses to an LLM wastes tokens and degrades performance.

reShapr introduces Context Control

🌟 Key Features

  • AI-Native Transformation: Auto-transform API services into LLM-friendly tools.
  • Context Control: Filter and slim down payloads before they reach the LLM.
  • Multi-Protocol: REST, GraphQL, and gRPC support.
  • No-Code: Configure and deploy in minutes.

📖 Full Documentation | Discord Community

Quick Start

Install the CLI

npm install -g @reshapr/reshapr-cli

Choose your platform

You have two simple options:

  1. Use the https://try.reshapr.io/ to try out the platform. Follow our detailed Try reShapr online guide.
  2. Run the platform locally using containers and Docker runtime. Follow the next section for details.

Run the platform locally

Assuming you have Docker installed, you can run the platform locally with the following command:

reshapr run

You should see a message like this:

ℹ️  Resolved 'latest' to release '0.2.2'.
ℹ️  Downloading compose file from https://raw.githubusercontent.com/reshaprio/reshapr/refs/tags/0.2.2/install/docker-compose-all-in-one.yml...
✅ Compose file saved to /Users/<you>/.reshapr/docker-compose-0.2.2.yml
ℹ️  Starting Reshapr containers (release: 0.2.2)...
✅ Reshapr containers started successfully.

Connect to the control plane at http://localhost:5555 with default credentials (admin/password):

reshapr login -s http://localhost:5555 -u admin -p password

Import an OpenAPI file:

reshapr import -u https://raw.githubusercontent.com/open-meteo/open-meteo/refs/heads/main/openapi.yml \
  --backendEndpoint https://api.open-meteo.com

You now have a fully functional MCP Server powered by reShapr at http://localhost:7777/mcp/reshapr/Open-Meteo+APIs/1.0 🎉

You can try it out using an MCP client, explore the CLI and more features!

Contributing

We ❤️ contributors! Reshapr is an open community, and we welcome contributions of all kinds — not just code. Every contribution matters and helps make Reshapr better for everyone:

  • 🐛 Report bugs or submit support requests via GitHub Issues
  • 📖 Improve documentation — fix a typo, clarify a guide, or write a new tutorial
  • 🧪 Write tests to increase coverage and reliability
  • 🎥 Create demos or share your use cases with the community
  • 💻 Submit code — bug fixes, features, or refactors are all welcome
  • 💬 Share testimonials — tell us how you use Reshapr and help spread the word

📋 Before contributing, please read our Contributing Guide to learn about our development workflow, coding conventions, and how to submit your changes.

Come say hi on our Discord server — whether you have questions, ideas, or just want to chat with the community. We'd love to hear from you! 🚀

Support the project! 🌟

If you think reShapr is useful for the AI ecosystem, give us a star on our main repository! It helps us get more visibility and keep the project growing.

Thanks!

Contributors Forkers repo roster for @reshaprio/reshapr

Files in the repo

Repository payload22 top-level entries
  • .github
  • .mvn
  • api
  • benchmarks
  • cli
  • commons
  • control-plane
  • dev
  • install
  • proxy
  • web-ui
  • .gitignore
  • CODE_OF_CONDUCT.md
  • CODEOWNERS
  • CONTRIBUTING.md
  • jreleaser.yml
  • LICENSE
  • pom.xml
  • README.md
  • reshapr-admin-ctrl-openapi-v0.1.yaml
  • reshapr-authentication-openapi-v0.1.yaml
  • reshapr-public-openapi-v0.1.yaml

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface

86k

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k