oshirase-mcp
OSデスクトップ通知とDiscord Webhook通知を送信するMCPサーバー
Open source Open in the app JSON README (API)
About
OSデスクトップ通知とDiscord Webhook通知を送信するMCPサーバー
Details
- Kind
- Plugins
- Topic
- Communication
- Publisher
- dovahkiinyuzuko
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.1.1
- Forks
- 1
- Last push
- 2026-05-20T14:36:10Z
- Repository state
- ativo
- Language
- Rust
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
dovahkiinyuzuko/oshirase-mcp
README
# Oshirase-MCP > [!TIP] > **AI Agents**: Please refer to [AGENTS.md](./AGENTS.md) for specialized tool usage guidelines and instructions. [日本語](#日本語)|[English](#english) ## 日本語 ### 概要 Oshirase-MCPは、Model Context Protocol (MCP) を通じて、OSデスクトップ通知とDiscord Webhook通知を統合して管理・送信できるサーバーです。AIエージェントやCLIツールから、ビルド完了やエラーなどの情報を視覚的に受け取ることができます。 ### インストール方法 > [!WARNING] > Gemini CLIは2026年6月にサービス終了予定です。後継ツールである **Antigravity CLI** への移行を強く推奨します。 #### Antigravity CLI (推奨) GitHubリポジトリのURLを指定するだけで、自動でインストールが可能です。 ```bash agy plugin install https://github.com/DovahkiinYuzuko/Oshirase-MCP ``` *インストール中に設定に関するプロンプトが表示される場合があるので、画面の指示に従ってください。* #### Gemini CLI (旧環境向け・非推奨) GitHubリポジトリのURLを指定するだけで、バイナリのダウンロードから設定まで自動で行えます。 ```bash gemini extensions install https://github.com/DovahkiinYuzuko/Oshirase-MCP ``` *インストール中に Discord Webhook URL などの設定を聞かれるので、画面の指示に従ってください。* #### Claude Code / Codex CLI 等のその他のツール Gemini CLI以外のツールを使用する場合は、まず以下のコマンドでシステムにバイナリをインストールします。 **Windows (PowerShell):** ```powershell irm https://github.com/DovahkiinYuzuko/Oshirase-MCP/releases/latest/download/oshirase-mcp-installer.ps1 | iex ``` **macOS / Linux:** ```bash curl --proto '=https' --tlsv1.2 -LsSf https://github.com/DovahkiinYuzuko/Oshirase-MCP/releases/latest/download/oshirase-mcp-installer.sh | sh ``` インストール後、各ツールの設定ファイルにバイナリのパス（通常は `~/.cargo/bin/oshirase-mcp` または `%USERPROFILE%\.cargo\bin\oshirase-mcp.exe`）を指定します。 **Claude Code の場合:** ```bash claude mcp add oshirase --command "oshirase-mcp" --args "--mcp" ``` **Codex CLI の場合** (`~/.codex/config.toml`): ```toml [mcp_servers.oshirase] command = "oshirase-mcp" args = ["--mcp"] ``` *(※パスが通っていない場合はフルパスを指定してください)* ### 使い方 1. **ビルド**: `oshirase-mcp-server` フォルダへ移動し、`cargo build --release` を実行します。 2. **MCP登録**: お使いのAIエージェント（Gemini CLI, Claude, Cursor等）に、ビルドしたバイナリをMCPサーバーとして登録します。 3. **設定**: 初回起動時に生成される `config.toml` に Discord Webhook などを設定してください。 ### リポジトリ構成 - `oshirase-mcp-server/`: MCPサーバーのソースコードとビルド用ファイル。 - `LICENSE`: MITライセンス。 - `NOTICE.md`: サードパーティ製ライブラリのライセンス告知。 詳細なセットアップ手順については、[oshirase-mcp-server/README.md](./oshirase-mcp-server/README.md) を参照してください。 ## English ### Overview Oshirase-MCP is a unified server for managing and sending notifications via OS desktop alerts and Discord Webhooks through the Model Context Protocol (MCP). It allows AI agents and CLI tools to provide visual feedback for events like build completions or critical errors. ### Installation > [!WARNING] > Gemini CLI will be deprecated in June 2026. Transitioning to the successor, **Antigravity CLI**, is strongly recommended. #### Antigravity CLI (Recommended) You can install the extension directly from the GitHub repository URL. ```bash agy plugin install https://github.com/DovahkiinYuzuko/Oshirase-MCP ``` *Follow any on-screen prompts for configuration.* #### Gemini CLI (Legacy/Deprecated) You can install the extension directly from the GitHub repository URL. The binary download and initial configuration are handled automatically. ```bash gemini extensions install https://github.com/DovahkiinYuzuko/Oshirase-MCP ``` *You will be prompted to enter your Discord Webhook URL and other settings during installation.* #### Other tools like Claude Code / Codex CLI For tools other than Gemini CLI, first install the binary on your system using the commands below: **Windows (PowerShell):** ```powershell irm https://github.com/DovahkiinYuzuko/Oshirase-MCP/releases/latest/download/oshirase-mcp-installer.ps1 | iex ``` **macOS / Linux:** ```bash curl --proto '=https' --tlsv1.2 -LsSf https://github.com/DovahkiinYuzuko/Oshirase-MCP/releases/latest/download/oshirase-mcp-installer.sh | sh ``` After installation, configure your tool to use the installed binary (usually located at `~/.cargo/bin/oshirase-mcp` or `%USERPROFILE%\.cargo\bin\oshirase-mcp.exe`). **For Claude Code:** ```bash claude mcp add oshirase --command "oshirase-mcp" --args "--mcp" ``` **For Codex CLI** (in `~/.codex/config.toml`): ```toml [mcp_servers.oshirase] command = "oshirase-mcp" args = ["--mcp"] ``` *(Note: If the path is not resolved, use the absolute path to the executable)* ### Usage 1. **Build**: Navigate to the `oshirase-mcp-server` directory and run `cargo build --release`. 2. **MCP Registration**: Register the compiled binary as an MCP server in your AI agent (e.g., Gemini CLI, Claude, Cursor). 3. **Configuration**: Set up your Discord Webhook or other settings in the `config.toml` file generated upon the first run. ### Repository Structure - `oshirase-mcp-server/`: Source code and build files for the MCP server. - `LICENSE`: MIT License. - `NOTICE.md`: License notices for third-party libraries. For detailed setup instructions, please refer to [oshirase-mcp-server/README.md](./oshirase-mcp-server/README.md).