diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 00000000..38405975 --- /dev/null +++ b/.gitattributes @@ -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 diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 00000000..32ed59fa --- /dev/null +++ b/.github/CODEOWNERS @@ -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 diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000..9690a8ed --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -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. diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 00000000..59e505c1 --- /dev/null +++ b/CHANGELOG.md @@ -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. diff --git a/README.md b/README.md index 59143012..d1490d08 100644 --- a/README.md +++ b/README.md @@ -14,13 +14,45 @@

- โญ Star this repo if you find it useful โ€” it helps others discover AnythingMCP! + โญ Star this repo if you find it useful · ๐Ÿ‘€ Watch to get notified about new adapters and releases · ๐Ÿ”ฑ Fork to add your own connector

AnythingMCP โ€” source-available self-hosted MCP server and API gateway for Claude, ChatGPT, Gemini, Copilot and Cursor

+

+ AnythingMCP demo โ€” turning a REST API into an MCP server with no code +
+ Watch the 90-second demo video +

+ +
+๐Ÿ“– Table of Contents + +- [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) + +
+ --- ## Cloud & Deploy @@ -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. -

- AnythingMCP demo โ€” turning a REST API into an MCP server with no code -
- Watch the demo video -

- --- > ๐Ÿญ **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. @@ -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 @@ -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 + + + + + + AnythingMCP star history chart + + + +> โญ **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. diff --git a/SUPPORT.md b/SUPPORT.md new file mode 100644 index 00000000..a12ee5a7 --- /dev/null +++ b/SUPPORT.md @@ -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**   ยท   ๐ŸŒ **[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