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.
[!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
(Requires Node.js installed)
npm install -g @reshapr/reshapr-cli
Choose your platform
Choose how to get started:
- Try it online: Use try.reshapr.io for a fully managed sandbox. Follow our Try reShapr online guide.
- Run it locally (End-User): See the section below to spin up the latest published release.
- Contribute code / launch the Web UI (Developer): Head to install/README.md to run the
docker-composestack โ it uses:nightlydevelopment builds.
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 '1.0.0'.
โน๏ธ Downloading compose file from https://raw.githubusercontent.com/reshaprio/reshapr/refs/tags/1.0.0/install/docker-compose-all-in-one.yml...
โ
Compose file saved to /Users/<you>/.reshapr/docker-compose-1.0.0.yml
โน๏ธ Starting Reshapr containers (release: 1.0.0)...
โ
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/forecast.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-weather-forecast-api-1-0-default ๐
You can try it out using an MCP client, explore the CLI and more features!
Build Status
The current development version is 1.0.1-SNAPSHOT.
Signature, Provenance, SBOM
Sonarcloud Quality metrics
LFX Insights
OpenSSF best practices
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!
