Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# Normalize line endings to LF on checkin, native on checkout.
* text=auto eol=lf

# Shell scripts and Dockerfiles must always be LF.
*.sh text eol=lf
Dockerfile* text eol=lf
*.yml text eol=lf
*.yaml text eol=lf

# Tell GitHub Linguist to classify documentation, generated files, and assets
# correctly so the language stats reflect actual product code.
docs/** linguist-documentation
content/** linguist-documentation
*.md linguist-documentation
*.mdx linguist-documentation
ROADMAP.md linguist-documentation
CHANGELOG.md linguist-documentation
SUPPORT.md linguist-documentation
CONTRIBUTING.md linguist-documentation
SECURITY.md linguist-documentation
CODE_OF_CONDUCT.md linguist-documentation

# Lockfiles and large generated artefacts shouldn't pollute language stats.
package-lock.json linguist-generated
*.svg linguist-generated
*.png binary
*.jpg binary
*.gif binary
26 changes: 26 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# CODEOWNERS — review routing for AnythingMCP
#
# Defaults: any change requires review from a core maintainer.
* @keysersoft

# Adapter catalog — community PRs welcome, but a maintainer must validate
# the JSON schema and the catalog test before merge.
/packages/backend/src/adapters/ @keysersoft @D3nisty
/packages/backend/src/catalog.ts @keysersoft @D3nisty

# Frontend
/packages/frontend/ @keysersoft @mirkopoloni

# Infra & deployment
/Dockerfile @keysersoft
/docker-compose*.yml @keysersoft
/deploy/ @keysersoft
/railway.* @keysersoft
/setup.sh @keysersoft

# Documentation
/docs/ @keysersoft
/README.md @keysersoft
/CONTRIBUTING.md @keysersoft
/SECURITY.md @keysersoft
/ROADMAP.md @keysersoft
14 changes: 14 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
blank_issues_enabled: false
contact_links:
- name: 💬 Questions, ideas, show & tell
url: https://github.com/HelpCode-ai/anythingmcp/discussions
about: For anything that isn't a clear bug or feature request — please use Discussions so the answer helps everyone else too.
- name: 📚 Documentation & Guides
url: https://anythingmcp.com
about: 150+ adapter and AI-client setup guides in English, German, and Italian.
- name: 🔐 Security vulnerabilities
url: https://github.com/HelpCode-ai/anythingmcp/blob/main/SECURITY.md
about: Please do NOT open a public issue. Follow the security disclosure policy.
- name: 💼 Commercial licensing & support
url: mailto:info@helpcode.ai
about: For commercial use, custom adapters, SLA, or on-prem support contracts.
15 changes: 15 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Changelog

All notable changes to AnythingMCP are tracked on the [GitHub Releases page](https://github.com/HelpCode-ai/anythingmcp/releases).

Each release ships with a structured changelog covering fixes, new features, breaking changes (if any), and verification notes. Subscribe to releases by clicking **Watch → Custom → Releases** on the repository page.

## Quick links

- [Latest release](https://github.com/HelpCode-ai/anythingmcp/releases/latest)
- [All releases](https://github.com/HelpCode-ai/anythingmcp/releases)
- [Roadmap](ROADMAP.md)

## Versioning

AnythingMCP follows [Semantic Versioning](https://semver.org). While the project is on `0.x` we may introduce breaking changes between minor versions; each one is called out explicitly in the corresponding release notes.
59 changes: 51 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,45 @@
</p>

<p align="center">
<strong>⭐ Star this repo if you find it useful — it helps others discover AnythingMCP!</strong>
<strong>⭐ Star this repo</strong> if you find it useful &middot; <strong>👀 Watch</strong> to get notified about new adapters and releases &middot; <strong>🔱 Fork</strong> to add your own connector
</p>

<p align="center">
<img src="docs/assets/banner.png" alt="AnythingMCP — source-available self-hosted MCP server and API gateway for Claude, ChatGPT, Gemini, Copilot and Cursor" width="100%" />
</p>

<p align="center">
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docs/assets/demo.gif" alt="AnythingMCP demo — turning a REST API into an MCP server with no code" />
<br/>
<a href="https://anythingmcp.com/en/video-promo"><strong>Watch the 90-second demo video</strong></a>
</p>

<details>
<summary><strong>📖 Table of Contents</strong></summary>

- [Cloud & Deploy](#cloud--deploy)
- [What is AnythingMCP?](#what-is-anythingmcp)
- [Get Started in 60 Seconds](#get-started-in-60-seconds)
- [Use Cases](#use-cases)
- [Why AnythingMCP?](#why-anythingmcp)
- [How AnythingMCP Compares](#how-anythingmcp-compares)
- [Key Features](#key-features)
- [Pre-configured MCP Connectors](#pre-configured-mcp-connectors)
- [Quick Start](#quick-start)
- [Connect Your AI Client to the MCP Server](#connect-your-ai-client-to-the-mcp-server)
- [Connector Guides](#connector-guides)
- [Architecture](#architecture)
- [FAQ](#faq)
- [Documentation](#documentation)
- [Tech Stack](#tech-stack)
- [Development](#development)
- [Community & Support](#community--support)
- [Star History](#star-history)
- [Contributing](#contributing)
- [License](#license)

</details>

---

## Cloud & Deploy
Expand All @@ -45,12 +77,6 @@ No SDK. No code changes. Just point, configure, and connect.

> **Looking for an MCP gateway?** AnythingMCP acts as a universal MCP proxy and API-to-MCP bridge — the missing middleware between your APIs and AI agents.

<p align="center">
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docs/assets/demo.gif" alt="AnythingMCP demo — turning a REST API into an MCP server with no code" />
<br/>
<a href="https://anythingmcp.com/en/video-promo"><strong>Watch the demo video</strong></a>
</p>

---

> 🏭 **Built for production** — AnythingMCP was born from real-world needs at a German industrial group connecting 15+ legacy systems (ERP, CRM, IoT) to AI agents.
Expand Down Expand Up @@ -201,6 +227,8 @@ AnythingMCP ships with **29 ready-to-use MCP server adapters** — provide your

**Want to add your own?** Create a JSON adapter file in `packages/backend/src/adapters/` (organized by region, e.g. `de/`), register it in `catalog.ts`, and it becomes available to all users. The new `catalog.spec.ts` parametrized test validates every adapter at build time. See the existing adapters and the [Tool Definition Format](docs/tool-definition.md) for the expected schema.

> 👀 **Don't see your favourite SaaS?** [**Open a discussion**](https://github.com/HelpCode-ai/anythingmcp/discussions/categories/ideas) and we'll prioritise the next adapter based on community demand. ⭐ Star and 👀 Watch the repo to be notified when it ships.

---

## Quick Start
Expand Down Expand Up @@ -372,13 +400,28 @@ Or see the [Deployment Guide](docs/deployment.md#local-development) for manual s

## Community & Support

- **Questions & Discussions** — [GitHub Discussions](https://github.com/HelpCode-ai/anythingmcp/discussions)
- **Questions & Discussions** — [GitHub Discussions](https://github.com/HelpCode-ai/anythingmcp/discussions) — vote on the next adapter, share what you've built, ask for help
- **Bug Reports** — [Open an issue](https://github.com/HelpCode-ai/anythingmcp/issues)
- **Feature Requests** — [Request a feature](https://github.com/HelpCode-ai/anythingmcp/issues/new?labels=enhancement&template=feature_request.md)
- **Need help?** — see [SUPPORT.md](SUPPORT.md) for the full list of channels
- **Built by** [helpcode.ai](https://helpcode.ai) — AI-powered software development from Germany

---

## Star History

<a href="https://www.star-history.com/#HelpCode-ai/anythingmcp&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=HelpCode-ai/anythingmcp&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=HelpCode-ai/anythingmcp&type=Date" />
<img alt="AnythingMCP star history chart" src="https://api.star-history.com/svg?repos=HelpCode-ai/anythingmcp&type=Date" />
</picture>
</a>

> ⭐ **Like what you see?** [**Star this repo**](https://github.com/HelpCode-ai/anythingmcp/stargazers) — every star helps another developer discover AnythingMCP.

---

## Contributing

We welcome contributions! Please read our [Contributing Guide](CONTRIBUTING.md) before submitting a PR.
Expand Down
47 changes: 47 additions & 0 deletions SUPPORT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Getting help with AnythingMCP

Different questions go to different places — please use the right channel so we can answer faster.

## Ask the community first

The fastest answers usually come from other users. Before opening an issue, check:

- **[GitHub Discussions](https://github.com/HelpCode-ai/anythingmcp/discussions)** — Q&A, ideas, show & tell
- **Q&A** for "how do I…" questions
- **Ideas** for feature requests and "please add adapter X"
- **Show and tell** for sharing what you built
- **Announcements** for release notes and roadmap updates

## Documentation

- **[README](README.md)** — overview and quick start
- **[anythingmcp.com](https://anythingmcp.com)** — website with 150+ guides for individual adapters and AI clients (English / German / Italian)
- **[Deployment Guide](docs/deployment.md)** — production self-hosting
- **[API Reference](docs/api-reference.md)** — full REST API
- **[Tool Definition Format](docs/tool-definition.md)** — how adapter JSON files are structured
- **[License FAQ](docs/license-faq.md)** — what BSL-1.1 means in practice

## Bug reports

Found a reproducible bug? [Open an issue](https://github.com/HelpCode-ai/anythingmcp/issues/new/choose) using the **Bug report** template. Please include:

- Version (`docker compose exec backend npm version`, or `git rev-parse HEAD` for source builds)
- Deployment mode (Docker / Railway / DigitalOcean / Cloud)
- The smallest possible reproduction steps
- Logs (sanitise any credentials first)

## Security issues

**Do not** open a public issue for security vulnerabilities. Follow the [SECURITY.md](SECURITY.md) policy and email **info@helpcode.ai** instead.

## Commercial support

For commercial licensing, custom adapter development, on-prem support contracts, or SLA-backed Cloud plans:

📧 **info@helpcode.ai** &nbsp; · &nbsp; 🌐 **[helpcode.ai](https://helpcode.ai)**

## Stay in the loop

- ⭐ **Star** the repo
- 👀 **Watch → Custom → Releases** to be notified about new versions and adapters
- 📣 Follow [@helpcode_ai](https://twitter.com/helpcode_ai) for release announcements
Loading