reshapr

[](https://github.com/reshaprio/reshapr/actions) [](https://quay.io/repository/reshapr/reshapr-ctrl?tab=tags) []((https://central.sonatype.com/search?q=io.reshapr)) [](https://www.npmjs.com/package/@reshapr/reshapr-cli) [](https://www.apache.org/licenses/LICENSE-2.0) [](https://discord.gg/KyDUdam34h) [](https://github.com/reshaprio/reshapr) # Welcome to reShapr 🚀 [**Website**](https://reshapr.io/) | [**About**](https://reshapr.io/about) | [**Docs**](https://reshapr.io/docs/) | [**Blog**](https://reshapr.io/blog) | [**Community**](https://reshapr.io/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. <p align="center"> <a href="https://reshapr.io/docs/tutorials/getting-started"> <img src="https://raw.githubusercontent.com/reshaprio/.github/main/assets/demo-video-github-full.gif" width="750" alt="reShapr Demo - Click to get started"> </a> <br/> <em>✨ Transform any API into lean LLM contexts in seconds.</em> </p> > [!IMPORTANT] > To get involved with our community, please familiarize yourself with the project's [Code of Conduct](./CODE_OF_CONDUCT.md). ### 🧠 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**](https://reshapr.io/blog/from-context-overload-to-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**](https://reshapr.io/docs/) | [**Discord Community**](https://discord.gg/KyDUdam34h) ## Quick Start ### Install the CLI ```sh npm install -g @reshapr/reshapr-cli ``` ### Choose your platform You have two simple options: 1. Use the [https://try.reshapr.io/](https://try.reshapr.io/) to try out the platform. Follow our detailed [Try reShapr online](https://reshapr.io/docs/tutorials/try-reshapr-online) guide. 2. Run the platform locally using [containers and Docker runtime](https://reshapr.io/docs/how-to-guides/docker-compose). 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: ```sh reshapr run ``` You should see a message like this: ```sh ℹ️ Resolved 'latest' to release '0.0.13'. ℹ️ Downloading compose file from https://raw.githubusercontent.com/reshaprio/reshapr/refs/tags/0.0.13/install/docker-compose-all-in-one.yml... ✅ Compose file saved to /Users/<you>/.reshapr/docker-compose-0.0.13.yml ℹ️ Starting Reshapr containers (release: 0.0.13)... ✅ Reshapr containers started successfully. ``` Connect to the control plane at http://localhost:5555 with default credentials (`admin/password`): ```sh reshapr login -s http://localhost:5555 -u admin -p password ``` Import an OpenAPI file: ```sh 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](https://reshapr.io/docs/tutorials/getting-started) and [more features](https://reshapr.io/docs/references/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](https://github.com/reshaprio/reshapr/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](./CONTRIBUTING.md) to learn about our development workflow, coding conventions, and how to submit your changes. Come say hi on our [Discord server](https://discord.gg/KyDUdam34h) — 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](https://github.com/reshaprio/reshapr)! It helps us get more visibility and keep the project growing. ### Thanks! [](http://github.com/reshaprio/reshapr/stargazers) [](http://github.com/reshaprio/reshapr/network/members)