Omni Mcp Server

io.github.bitofacoder由 GitHub 账号 bitofacoder 发布v1.1.1更新于 Oct 24, 2026

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

概览

AI 生成的概览

一个本地 MCP 服务器,集成 GitHub、本地 Git、Slack、网页抓取、记忆和文件系统工具,默认关闭 shell 执行与文件写入。

可以做什么
搜索 GitHub 仓库并查看 issue 详情,GitHub 工具可选使用 GitHub 令牌。查看本地 Git 状态:status、diff、log,并提交已暂存的更改。读取本地文件、列出目录;仅在启用 Agent 模式时可写文件和执行 shell 命令。无需 API 密钥即可将公开网址抓取为干净的 Markdown。跨会话保存、检索和列出持久记忆笔记。配置 Slack 机器人令牌后可向 Slack 频道发送消息。
适用场景
适合希望用一个配置条目完成日常开发工作——查看仓库与 issue、审阅本地改动、读取文件、抓取网页和记录笔记——而不必安装多个独立服务器的情况。Agent 模式用于你明确希望助手在本机编辑文件或运行命令时。
运行要求
通过 npx 从 npm 包以 stdio 在本地运行,需要 Node.js。可选密钥:GITHUB_PERSONAL_ACCESS_TOKEN 用于 GitHub 工具,SLACK_BOT_TOKEN 用于 slack_send_message;缺少令牌的工具会提示。将 OMNI_AGENT_MODE 设为 'true' 可启用 shell 执行和文件写入。GitHub、Slack 和网页抓取需要网络访问。
安装前请注意
Agent 模式(OMNI_AGENT_MODE=true)会暴露 system_write_file 和 system_execute_command,使助手能在你的机器上写文件并执行任意 shell 命令;除非必要请保持关闭。git_commit 和 slack_send_message 会修改数据或发送消息。GITHUB_PERSONAL_ACCESS_TOKEN 和 SLACK_BOT_TOKEN 是保存在客户端配置中的密钥,请授予最小权限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Omni Mcp Server,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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.

[npm version] [npm downloads] [License: MIT] [Model Context Protocol]

[Omni MCP Server setup wizard configuring Claude Desktop and listing all 15 bundled tools, with Agent Mode 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)

bash
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

bash
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):

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:

json
"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.

来源:README.md,提交 5e6a756

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分