English Français العربية

io.github.bitofacoder/omni-mcp-server

Registre officiel Outils de développement

All-in-one MCP server: GitHub, Git, Slack, web fetch, memory, and filesystem. Agent Mode opt-in.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @bitofacoder/omni-mcp-server
Claude Code 
claude mcp add omni-mcp-server -e 'GITHUB_PERSONAL_ACCESS_TOKEN=<your github_personal_access_token>' -e 'SLACK_BOT_TOKEN=<your slack_bot_token>' -e 'OMNI_AGENT_MODE=<OMNI_AGENT_MODE>' -- npx -y @bitofacoder/omni-mcp-server@1.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "omni-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@bitofacoder/omni-mcp-server@1.1.1"
            ],
            "env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN": "<your github_personal_access_token>",
                "SLACK_BOT_TOKEN": "<your slack_bot_token>",
                "OMNI_AGENT_MODE": "<OMNI_AGENT_MODE>"
            }
        }
    }
}

Variables d'environnement

  • GITHUB_PERSONAL_ACCESS_TOKEN secret GitHub token for the GitHub tools (optional)
  • SLACK_BOT_TOKEN secret Slack bot token for slack_send_message (optional)
  • OMNI_AGENT_MODE Set to 'true' to enable Agent Mode (shell execution and file writes). Disabled by default.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Omni MCP Server 🚀
  2. Why Omni?
  3. 🚀 Quick Start
  4. 🛠️ Tools (15)
  5. 🔒 Agent Mode (opt-in)
  6. 🤝 Contributing
  7. 📄 License

Omni MCP Server 🚀

One MCP server instead of six. GitHub, local Git, Slack, web fetching, persistent memory, and filesystem tools — 15 tools in a single config entry, with dangerous capabilities off by default.

Why Omni?

Setting up MCP usually means installing and configuring a separate server for every capability — one for GitHub, one for filesystem, one for memory, one for fetch. Each has its own config block, its own runtime, its own startup cost.

Omni bundles the everyday developer tools into one server, one config entry, one npx command:

You'd normally install…With Omni
server-github✅ built in
server-filesystem✅ built in
server-memory✅ built in
server-fetch✅ built in
a git server✅ built in
a Slack server✅ built in
  • 🔒 Safe by default — shell execution and file writes are disabled unless you explicitly opt in to Agent Mode.
  • 🏠 Local & private — runs on your machine over stdio. You bring your own tokens; nothing is proxied through a third party.
  • 🪶 Zero install — runs straight from npm via npx.

🚀 Quick Start

Interactive setup (Claude Desktop)
npx -y @bitofacoder/omni-mcp-server@latest setup

The wizard asks for your optional tokens (GitHub, Slack), asks whether to enable Agent Mode, and updates your Claude Desktop config for you. Restart Claude Desktop and you're done.

Claude Code
claude mcp add omni -e GITHUB_PERSONAL_ACCESS_TOKEN=your_gh_token -- npx -y @bitofacoder/omni-mcp-server@latest
Manual config (Claude Desktop, Cursor, Windsurf, Codex CLI…)

Add this to your client's MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "omni": {
      "command": "npx",
      "args": ["-y", "@bitofacoder/omni-mcp-server@latest"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_gh_token",
        "SLACK_BOT_TOKEN": "your_slack_token"
      }
    }
  }
}

All env vars are optional — tools that need a missing token simply tell you so.

🛠️ Tools (15)

GroupToolWhat it does
🐙 GitHubgithub_search_reposSearch GitHub repositories
github_get_issueGet details of a specific issue
🌳 Local Gitgit_statusWorking tree + staging area status
git_diffView local code changes
git_logView commit history
git_commitCommit staged changes with a message
💻 Systemsystem_read_fileRead a local file
system_list_dirList a directory
system_write_file⚠️ Write a file (Agent Mode only)
system_execute_command⚠️ Run a shell command (Agent Mode only)
🌐 Webweb_fetchFetch any public URL as clean Markdown — no API key needed
🧠 Memorymemory_storeSave a note/preference across chats
memory_retrieveRetrieve a saved memory
memory_listList everything remembered
💬 Slackslack_send_messageSend a message to a Slack channel

🔒 Agent Mode (opt-in)

system_execute_command and system_write_file let the AI act on your machine — run tests, install packages, edit files. Because that's real power, they are disabled by default and don't even appear in the tool list until you enable them:

"env": {
  "OMNI_AGENT_MODE": "true"
}

Everything else (reading files, git status, web fetch, memory) is read-only or sandboxed to its own data file.

🤝 Contributing

PRs welcome — especially new integrations (Linear, Notion, Jira, Discord) and Agent Mode hardening (allowlists, working-dir scoping). Open an issue first for bigger changes.

If Omni saved you some config wrangling, a ⭐ helps other people find it.

📄 License

MIT — see LICENSE.

Questions fréquentes

Qu'est-ce que io.github.bitofacoder/omni-mcp-server ?

All-in-one MCP server: GitHub, Git, Slack, web fetch, memory, and filesystem. Agent Mode opt-in.

Comment installer io.github.bitofacoder/omni-mcp-server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add omni-mcp-server -e 'GITHUB_PERSONAL_ACCESS_TOKEN=<your github_personal_access_token>' -e 'SLACK_BOT_TOKEN=<your slack_bot_token>' -e 'OMNI_AGENT_MODE=<OMNI_AGENT_MODE>' -- npx -y @bitofacoder/omni-mcp-server@1.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.bitofacoder/omni-mcp-server ?

Oui. Il attend GITHUB_PERSONAL_ACCESS_TOKEN, SLACK_BOT_TOKEN, à renseigner dans sa configuration.

io.github.bitofacoder/omni-mcp-server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.bitofacoder/omni-mcp-server ?

Il est publié par bitofacoder. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.