omni-mcp-server

Omni MCP Server 🚀

6つの代わりに、1つのMCP サーバー。 GitHub、ローカル Git、Slack、Web フェッチ、永続メモリ、ファイルシステムのツールを、1つの設定項目にまとめた15個のツールで利用できます。危険な機能はデフォルトで無効になっています。

Omni を選ぶ理由

通常、MCP のセットアップでは機能ごとに別々のサーバーをインストールして設定する必要があります。GitHub 用、ファイルシステム用、メモリ用、フェッチ用などです。それぞれに独自の設定ブロック、ランタイム、起動コストがあります。

Omni は日常的に使う開発者ツールを、1つのサーバー、1つの設定項目、1つの npx コマンドにまとめます。

通常インストールするもの…	Omni の場合
server-github	✅ 組み込み
server-filesystem	✅ 組み込み
server-memory	✅ 組み込み
server-fetch	✅ 組み込み
git サーバー	✅ 組み込み
Slack サーバー	✅ 組み込み

• 🔒 デフォルトで安全 — Agent Mode を明示的に有効にしない限り、シェルの実行とファイルへの書き込みは無効です。
• 🏠 ローカルでプライベート — 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	指定した Issue の詳細を取得
🌳 ローカル Git	git_status	ワーキングツリーとステージングエリアの状態を確認
	git_diff	ローカルのコード変更を表示
	git_log	コミット履歴を表示
	git_commit	ステージされた変更をメッセージ付きでコミット
💻 システム	system_read_file	ローカルファイルを読み取る
	system_list_dir	ディレクトリの内容を一覧表示
	system_write_file	⚠️ ファイルに書き込む (Agent Mode のみ)
	system_execute_command	⚠️ シェルコマンドを実行 (Agent Mode のみ)
🌐 Web	web_fetch	API キー不要で、公開 URL を読みやすい Markdown として取得
🧠 メモリ	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 の状態確認、Web フェッチ、メモリ）は、読み取り専用であるか、専用のデータファイル内に制限されています。

🤝 コントリビュート

プルリクエストを歓迎します。特に、新しい連携機能（Linear、Notion、Jira、Discord）や Agent Mode の強化（許可リスト、作業ディレクトリの制限）をお待ちしています。大きな変更については、まず Issue を作成してください。

Omni によって設定の手間が省けたら、⭐を付けていただけると、ほかの人にも見つけてもらいやすくなります。

📄 ライセンス

MIT — LICENSE をご覧ください。