omni-mcp-server

Omni MCP Server 🚀

用一个 MCP 服务代替六个。 GitHub、本地 Git、Slack、网页抓取、持久化记忆和文件系统工具——15 个工具集成在一条配置项中，危险功能默认关闭。

为什么选择 Omni？

通常，设置 MCP 意味着要为每种能力分别安装和配置一个服务——GitHub 一个、文件系统一个、记忆一个、抓取一个。每个都有自己的配置块、运行时和启动开销。

Omni 将日常开发工具整合到一个服务、一条配置项、一条 npx 命令中：

通常需要安装……	使用 Omni
server-github	✅ 内置
server-filesystem	✅ 内置
server-memory	✅ 内置
server-fetch	✅ 内置
一个 git 服务	✅ 内置
一个 Slack 服务	✅ 内置

• 🔒 默认安全——除非你主动选择启用 Agent Mode，否则禁用 shell 执行和文件写入。
• 🏠 本地且私密——在你的机器上通过 stdio 运行。你自行提供令牌；不会通过第三方代理。
• 🪶 无需安装——通过 npx 直接从 npm 运行。

🚀 快速开始

交互式设置（Claude Desktop）

npx -y @bitofacoder/omni-mcp-server@latest setup

向导会询问你是否要提供令牌（GitHub、Slack）、是否启用 Agent Mode，并为你更新 Claude Desktop 配置。重启 Claude Desktop 即可完成。

Claude Code

claude mcp add omni -e GITHUB_PERSONAL_ACCESS_TOKEN=your_gh_token -- npx -y @bitofacoder/omni-mcp-server@latest

手动配置（Claude Desktop、Cursor、Windsurf、Codex CLI……）

将以下内容添加到客户端的 MCP 配置中（例如 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"
      }
    }
  }
}

所有环境变量都是可选的——需要但缺少令牌的工具会直接告知你。

🛠️ 工具（15 个）

分组	工具	功能
🐙 GitHub	github_search_repos	搜索 GitHub 仓库
	github_get_issue	获取特定问题的详情
🌳 本地 Git	git_status	查看工作树和暂存区状态
	git_diff	查看本地代码更改
	git_log	查看提交历史
	git_commit	使用消息提交已暂存的更改
💻 系统	system_read_file	读取本地文件
	system_list_dir	列出目录内容
	system_write_file	⚠️ 写入文件 （仅限 Agent Mode）
	system_execute_command	⚠️ 运行 shell 命令 （仅限 Agent Mode）
🌐 网页	web_fetch	将任意公开 URL 抓取为简洁的 Markdown——无需 API 密钥
🧠 记忆	memory_store	在不同聊天间保存笔记或偏好
	memory_retrieve	检索已保存的记忆
	memory_list	列出所有已记住的内容
💬 Slack	slack_send_message	向 Slack 频道发送消息

🔒 Agent Mode（主动启用）

system_execute_command 和 system_write_file 允许 AI 在你的机器上执行操作——运行测试、安装软件包、编辑文件。由于这些功能权限很大，默认处于禁用状态，并且只有启用后才会出现在工具列表中：

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

其他所有功能（读取文件、查看 git 状态、网页抓取、记忆）都是只读的，或仅限访问自身的数据文件。

🤝 参与贡献

欢迎提交 PR——尤其是新增集成（Linear、Notion、Jira、Discord）以及强化 Agent Mode（允许列表、工作目录范围限制）。较大的改动请先提交 issue。

如果 Omni 为你省去了繁琐的配置工作，点个 ⭐ 就能帮助更多人发现它。

📄 许可证

MIT——参见 LICENSE。