omnibridge-mcp 1.0.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- omnibridge_mcp-1.0.0/LICENSE +21 -0
- omnibridge_mcp-1.0.0/PKG-INFO +196 -0
- omnibridge_mcp-1.0.0/README.md +177 -0
- omnibridge_mcp-1.0.0/omnibridge/__init__.py +8 -0
- omnibridge_mcp-1.0.0/omnibridge/_genesis.py +11 -0
- omnibridge_mcp-1.0.0/omnibridge/channels/__init__.py +8 -0
- omnibridge_mcp-1.0.0/omnibridge/channels/base.py +22 -0
- omnibridge_mcp-1.0.0/omnibridge/channels/discord.py +62 -0
- omnibridge_mcp-1.0.0/omnibridge/channels/telegram.py +56 -0
- omnibridge_mcp-1.0.0/omnibridge/cli.py +70 -0
- omnibridge_mcp-1.0.0/omnibridge/server.py +257 -0
- omnibridge_mcp-1.0.0/omnibridge_mcp.egg-info/PKG-INFO +196 -0
- omnibridge_mcp-1.0.0/omnibridge_mcp.egg-info/SOURCES.txt +18 -0
- omnibridge_mcp-1.0.0/omnibridge_mcp.egg-info/dependency_links.txt +1 -0
- omnibridge_mcp-1.0.0/omnibridge_mcp.egg-info/entry_points.txt +3 -0
- omnibridge_mcp-1.0.0/omnibridge_mcp.egg-info/requires.txt +4 -0
- omnibridge_mcp-1.0.0/omnibridge_mcp.egg-info/top_level.txt +1 -0
- omnibridge_mcp-1.0.0/pyproject.toml +34 -0
- omnibridge_mcp-1.0.0/setup.cfg +4 -0
- omnibridge_mcp-1.0.0/tests/test_genesis_entrypoints.py +25 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Johann Schiffer / NEXUS
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: omnibridge-mcp
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Lightweight, resilient multi-channel notification and webhook MCP server for AI agents
|
|
5
|
+
Author: Johann Schiffer
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://johannschiffer.github.io
|
|
8
|
+
Project-URL: Repository, https://github.com/johannschiffer/omnibridge-mcp
|
|
9
|
+
Project-URL: Starter Kit, https://johanld.gumroad.com/l/genesis-starter-kit
|
|
10
|
+
Project-URL: Enterprise Suite, https://johanld.gumroad.com/l/genesis-enterprise-suite
|
|
11
|
+
Keywords: mcp,model-context-protocol,claude,cursor,telegram,discord,notifications,ai-agent
|
|
12
|
+
Requires-Python: >=3.10
|
|
13
|
+
Description-Content-Type: text/markdown
|
|
14
|
+
License-File: LICENSE
|
|
15
|
+
Requires-Dist: httpx>=0.25.0
|
|
16
|
+
Provides-Extra: test
|
|
17
|
+
Requires-Dist: pytest>=7; extra == "test"
|
|
18
|
+
Dynamic: license-file
|
|
19
|
+
|
|
20
|
+
# OmniBridge MCP (Lite Edition)
|
|
21
|
+
|
|
22
|
+
<a href="https://glama.ai/mcp/servers/@johannschiffer/omnibridge-mcp">
|
|
23
|
+
<img width="380" height="200" src="https://glama.ai/mcp/servers/@johannschiffer/omnibridge-mcp/badge" alt="omnibridge-mcp MCP server" />
|
|
24
|
+
</a>
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
> **Free:** [Genesis Starter Kit](https://johanld.gumroad.com/l/genesis-starter-kit) (25 `.cursorrules`/`CLAUDE.md` rulesets + MCP configs). Try the [live config builder](https://johannschiffer.github.io).
|
|
28
|
+
> **Full stack:** all six servers in [Genesis Enterprise Suite ($19)](https://johanld.gumroad.com/l/genesis-enterprise-suite).
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
[](LICENSE)
|
|
32
|
+
[](https://python.org)
|
|
33
|
+
[](https://modelcontextprotocol.io)
|
|
34
|
+
|
|
35
|
+
**OmniBridge MCP** is a lightweight, zero-latency Model Context Protocol server that gives AI agents (in **Claude Desktop**, **Cursor**, **Windsurf**, and **Antigravity**) direct, controlled access to send real-time alerts, operational notifications, and webhooks without exposing your primary API keys or relying on bloated middleware.
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Run without cloning
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
uvx --from git+https://github.com/johannschiffer/omnibridge-mcp omnibridge-mcp
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Claude Desktop / Cursor config entry:
|
|
46
|
+
|
|
47
|
+
```json
|
|
48
|
+
{
|
|
49
|
+
"mcpServers": {
|
|
50
|
+
"omnibridge-mcp": {
|
|
51
|
+
"command": "uvx",
|
|
52
|
+
"args": [
|
|
53
|
+
"--from",
|
|
54
|
+
"git+https://github.com/johannschiffer/omnibridge-mcp",
|
|
55
|
+
"omnibridge-mcp"
|
|
56
|
+
]
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
[](https://github.com/johannschiffer/omnibridge-mcp/actions/workflows/ci.yml)
|
|
63
|
+
|
|
64
|
+
## โก Key Features (Lite Edition)
|
|
65
|
+
|
|
66
|
+
- ๐ **Zero Heavy Dependencies**: Pure Python implementation with minimal footprint (`httpx`).
|
|
67
|
+
- ๐ฌ **Telegram Bot API**: Send markdown-formatted alerts, silent notifications, and direct messages.
|
|
68
|
+
- ๐ฎ **Discord Webhooks**: Send rich embed cards with custom colors, titles, and timestamps.
|
|
69
|
+
- ๐ **Universal Compatibility**: Works out of the box with any MCP-compliant client via standard IO (`stdio`).
|
|
70
|
+
- ๐งช **Built-in CLI**: Interactive test tool to verify credentials and channel delivery in seconds.
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## ๐ Quick Setup in 2 Minutes
|
|
75
|
+
|
|
76
|
+
### 1. Installation
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
git clone https://github.com/johannschiffer/omnibridge-mcp.git
|
|
80
|
+
cd omnibridge-mcp
|
|
81
|
+
pip install -r requirements.txt
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### 2. Environment Variables
|
|
85
|
+
|
|
86
|
+
Create a `.env` file or export variables in your shell:
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
# Telegram Bot Token (from @BotFather)
|
|
90
|
+
export TELEGRAM_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ"
|
|
91
|
+
|
|
92
|
+
# Discord Webhook URL (from Channel Settings -> Integrations -> Webhooks)
|
|
93
|
+
export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
### 3. Verify with CLI
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
# Check channels configuration
|
|
100
|
+
python -m omnibridge.cli status
|
|
101
|
+
|
|
102
|
+
# Send a test alert to Discord
|
|
103
|
+
python -m omnibridge.cli test --channel discord --message "OmniBridge is live!"
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## ๐ฅ๏ธ Client Configuration
|
|
109
|
+
|
|
110
|
+
### Claude Desktop (`claude_desktop_config.json`)
|
|
111
|
+
|
|
112
|
+
On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
113
|
+
On Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
114
|
+
On Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
115
|
+
|
|
116
|
+
```json
|
|
117
|
+
{
|
|
118
|
+
"mcpServers": {
|
|
119
|
+
"omnibridge": {
|
|
120
|
+
"command": "python",
|
|
121
|
+
"args": ["-m", "omnibridge.server"],
|
|
122
|
+
"cwd": "/path/to/omnibridge-mcp",
|
|
123
|
+
"env": {
|
|
124
|
+
"TELEGRAM_BOT_TOKEN": "your_bot_token_here",
|
|
125
|
+
"DISCORD_WEBHOOK_URL": "your_discord_webhook_url_here"
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
### Cursor (`.cursor/mcp.json`)
|
|
133
|
+
|
|
134
|
+
```json
|
|
135
|
+
{
|
|
136
|
+
"mcpServers": {
|
|
137
|
+
"omnibridge": {
|
|
138
|
+
"command": "python -m omnibridge.server",
|
|
139
|
+
"env": {
|
|
140
|
+
"TELEGRAM_BOT_TOKEN": "your_bot_token_here",
|
|
141
|
+
"DISCORD_WEBHOOK_URL": "your_discord_webhook_url_here"
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## ๐ ๏ธ MCP Tools Available
|
|
151
|
+
|
|
152
|
+
| Tool | Parameters | Description |
|
|
153
|
+
|---|---|---|
|
|
154
|
+
| `send_telegram_message` | `chat_id`, `text`, `disable_notification` | Sends Telegram notification with Markdown support |
|
|
155
|
+
| `send_discord_alert` | `content`, `title`, `description`, `color`, `webhook_url` | Sends Discord rich embed card |
|
|
156
|
+
| `get_channel_status` | *(none)* | Returns connectivity and health of all channels |
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## ๐ Need Enterprise Features? Upgrade to OmniBridge Pro
|
|
161
|
+
|
|
162
|
+
Looking for production-grade reliability, business messaging, and fault tolerance?
|
|
163
|
+
|
|
164
|
+
| Feature | Lite (Open Source) | Enterprise Suite ($19) |
|
|
165
|
+
|---|:---:|:---:|
|
|
166
|
+
| **Telegram Bot API** | โ
| โ
|
|
|
167
|
+
| **Discord Webhooks** | โ
| โ
|
|
|
168
|
+
| **WhatsApp Cloud API** | โ | โ
|
|
|
169
|
+
| **Slack Block Kit & Webhooks** | โ | โ
|
|
|
170
|
+
| **Matrix Protocol Rooms** | โ | โ
|
|
|
171
|
+
| **Custom Webhooks with HMAC** | โ | โ
|
|
|
172
|
+
| **Offline WAL Resilient Queue** *(Zero Message Loss)* | โ | โ
|
|
|
173
|
+
| **Adaptive Rate Limiting** *(Anti-ban protection)* | โ | โ
|
|
|
174
|
+
| **Production Docker & Compose** | โ | โ
|
|
|
175
|
+
| **Full Pytest Suite & Architecture PDF** | โ | โ
|
|
|
176
|
+
|
|
177
|
+
๐ **[Get the Genesis Enterprise Suite ($19)](https://johanld.gumroad.com/l/genesis-enterprise-suite)**
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## ๐ License
|
|
182
|
+
|
|
183
|
+
MIT License. See [LICENSE](LICENSE) for details.
|
|
184
|
+
|
|
185
|
+
## Genesis MCP Ecosystem
|
|
186
|
+
|
|
187
|
+
| Module | What it does | Repo |
|
|
188
|
+
|---|---|---|
|
|
189
|
+
| **CrawlEngine MCP** | Anti-bot web scraping, clean Markdown, proxy rotation and TLS evasion | [GitHub](https://github.com/johannschiffer/crawlengine-mcp) |
|
|
190
|
+
| **BrowserBridge MCP** | Deterministic headless browser automation with cryptographic action receipts | [GitHub](https://github.com/johannschiffer/browserbridge-mcp) |
|
|
191
|
+
| **PgSafe MCP** | Zero-trust PostgreSQL/SQLite guard, live PII masking, zero-downtime migration checks | [GitHub](https://github.com/johannschiffer/pgsafe-mcp) |
|
|
192
|
+
| **OmniBridge MCP** (this repo) | Multi-channel notification and webhook bus with a persistent SQLite WAL queue | [GitHub](https://github.com/johannschiffer/omnibridge-mcp) |
|
|
193
|
+
| **SysFlow MCP** | Safe Linux administration plane: systemd, port audit, isolated execution | [GitHub](https://github.com/johannschiffer/sysflow-mcp) |
|
|
194
|
+
| **FastMCP Forge** | Production MCP server scaffolder: stdio, SSE and auth middleware | [GitHub](https://github.com/johannschiffer/fastmcp-forge) |
|
|
195
|
+
|
|
196
|
+
[Live config builder](https://johannschiffer.github.io) | [Starter Kit, free](https://johanld.gumroad.com/l/genesis-starter-kit) | [Enterprise Suite, $19](https://johanld.gumroad.com/l/genesis-enterprise-suite)
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
# OmniBridge MCP (Lite Edition)
|
|
2
|
+
|
|
3
|
+
<a href="https://glama.ai/mcp/servers/@johannschiffer/omnibridge-mcp">
|
|
4
|
+
<img width="380" height="200" src="https://glama.ai/mcp/servers/@johannschiffer/omnibridge-mcp/badge" alt="omnibridge-mcp MCP server" />
|
|
5
|
+
</a>
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
> **Free:** [Genesis Starter Kit](https://johanld.gumroad.com/l/genesis-starter-kit) (25 `.cursorrules`/`CLAUDE.md` rulesets + MCP configs). Try the [live config builder](https://johannschiffer.github.io).
|
|
9
|
+
> **Full stack:** all six servers in [Genesis Enterprise Suite ($19)](https://johanld.gumroad.com/l/genesis-enterprise-suite).
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
[](LICENSE)
|
|
13
|
+
[](https://python.org)
|
|
14
|
+
[](https://modelcontextprotocol.io)
|
|
15
|
+
|
|
16
|
+
**OmniBridge MCP** is a lightweight, zero-latency Model Context Protocol server that gives AI agents (in **Claude Desktop**, **Cursor**, **Windsurf**, and **Antigravity**) direct, controlled access to send real-time alerts, operational notifications, and webhooks without exposing your primary API keys or relying on bloated middleware.
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Run without cloning
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
uvx --from git+https://github.com/johannschiffer/omnibridge-mcp omnibridge-mcp
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Claude Desktop / Cursor config entry:
|
|
27
|
+
|
|
28
|
+
```json
|
|
29
|
+
{
|
|
30
|
+
"mcpServers": {
|
|
31
|
+
"omnibridge-mcp": {
|
|
32
|
+
"command": "uvx",
|
|
33
|
+
"args": [
|
|
34
|
+
"--from",
|
|
35
|
+
"git+https://github.com/johannschiffer/omnibridge-mcp",
|
|
36
|
+
"omnibridge-mcp"
|
|
37
|
+
]
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
[](https://github.com/johannschiffer/omnibridge-mcp/actions/workflows/ci.yml)
|
|
44
|
+
|
|
45
|
+
## โก Key Features (Lite Edition)
|
|
46
|
+
|
|
47
|
+
- ๐ **Zero Heavy Dependencies**: Pure Python implementation with minimal footprint (`httpx`).
|
|
48
|
+
- ๐ฌ **Telegram Bot API**: Send markdown-formatted alerts, silent notifications, and direct messages.
|
|
49
|
+
- ๐ฎ **Discord Webhooks**: Send rich embed cards with custom colors, titles, and timestamps.
|
|
50
|
+
- ๐ **Universal Compatibility**: Works out of the box with any MCP-compliant client via standard IO (`stdio`).
|
|
51
|
+
- ๐งช **Built-in CLI**: Interactive test tool to verify credentials and channel delivery in seconds.
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## ๐ Quick Setup in 2 Minutes
|
|
56
|
+
|
|
57
|
+
### 1. Installation
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
git clone https://github.com/johannschiffer/omnibridge-mcp.git
|
|
61
|
+
cd omnibridge-mcp
|
|
62
|
+
pip install -r requirements.txt
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### 2. Environment Variables
|
|
66
|
+
|
|
67
|
+
Create a `.env` file or export variables in your shell:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# Telegram Bot Token (from @BotFather)
|
|
71
|
+
export TELEGRAM_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ"
|
|
72
|
+
|
|
73
|
+
# Discord Webhook URL (from Channel Settings -> Integrations -> Webhooks)
|
|
74
|
+
export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### 3. Verify with CLI
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
# Check channels configuration
|
|
81
|
+
python -m omnibridge.cli status
|
|
82
|
+
|
|
83
|
+
# Send a test alert to Discord
|
|
84
|
+
python -m omnibridge.cli test --channel discord --message "OmniBridge is live!"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## ๐ฅ๏ธ Client Configuration
|
|
90
|
+
|
|
91
|
+
### Claude Desktop (`claude_desktop_config.json`)
|
|
92
|
+
|
|
93
|
+
On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
94
|
+
On Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
95
|
+
On Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
96
|
+
|
|
97
|
+
```json
|
|
98
|
+
{
|
|
99
|
+
"mcpServers": {
|
|
100
|
+
"omnibridge": {
|
|
101
|
+
"command": "python",
|
|
102
|
+
"args": ["-m", "omnibridge.server"],
|
|
103
|
+
"cwd": "/path/to/omnibridge-mcp",
|
|
104
|
+
"env": {
|
|
105
|
+
"TELEGRAM_BOT_TOKEN": "your_bot_token_here",
|
|
106
|
+
"DISCORD_WEBHOOK_URL": "your_discord_webhook_url_here"
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Cursor (`.cursor/mcp.json`)
|
|
114
|
+
|
|
115
|
+
```json
|
|
116
|
+
{
|
|
117
|
+
"mcpServers": {
|
|
118
|
+
"omnibridge": {
|
|
119
|
+
"command": "python -m omnibridge.server",
|
|
120
|
+
"env": {
|
|
121
|
+
"TELEGRAM_BOT_TOKEN": "your_bot_token_here",
|
|
122
|
+
"DISCORD_WEBHOOK_URL": "your_discord_webhook_url_here"
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## ๐ ๏ธ MCP Tools Available
|
|
132
|
+
|
|
133
|
+
| Tool | Parameters | Description |
|
|
134
|
+
|---|---|---|
|
|
135
|
+
| `send_telegram_message` | `chat_id`, `text`, `disable_notification` | Sends Telegram notification with Markdown support |
|
|
136
|
+
| `send_discord_alert` | `content`, `title`, `description`, `color`, `webhook_url` | Sends Discord rich embed card |
|
|
137
|
+
| `get_channel_status` | *(none)* | Returns connectivity and health of all channels |
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## ๐ Need Enterprise Features? Upgrade to OmniBridge Pro
|
|
142
|
+
|
|
143
|
+
Looking for production-grade reliability, business messaging, and fault tolerance?
|
|
144
|
+
|
|
145
|
+
| Feature | Lite (Open Source) | Enterprise Suite ($19) |
|
|
146
|
+
|---|:---:|:---:|
|
|
147
|
+
| **Telegram Bot API** | โ
| โ
|
|
|
148
|
+
| **Discord Webhooks** | โ
| โ
|
|
|
149
|
+
| **WhatsApp Cloud API** | โ | โ
|
|
|
150
|
+
| **Slack Block Kit & Webhooks** | โ | โ
|
|
|
151
|
+
| **Matrix Protocol Rooms** | โ | โ
|
|
|
152
|
+
| **Custom Webhooks with HMAC** | โ | โ
|
|
|
153
|
+
| **Offline WAL Resilient Queue** *(Zero Message Loss)* | โ | โ
|
|
|
154
|
+
| **Adaptive Rate Limiting** *(Anti-ban protection)* | โ | โ
|
|
|
155
|
+
| **Production Docker & Compose** | โ | โ
|
|
|
156
|
+
| **Full Pytest Suite & Architecture PDF** | โ | โ
|
|
|
157
|
+
|
|
158
|
+
๐ **[Get the Genesis Enterprise Suite ($19)](https://johanld.gumroad.com/l/genesis-enterprise-suite)**
|
|
159
|
+
|
|
160
|
+
---
|
|
161
|
+
|
|
162
|
+
## ๐ License
|
|
163
|
+
|
|
164
|
+
MIT License. See [LICENSE](LICENSE) for details.
|
|
165
|
+
|
|
166
|
+
## Genesis MCP Ecosystem
|
|
167
|
+
|
|
168
|
+
| Module | What it does | Repo |
|
|
169
|
+
|---|---|---|
|
|
170
|
+
| **CrawlEngine MCP** | Anti-bot web scraping, clean Markdown, proxy rotation and TLS evasion | [GitHub](https://github.com/johannschiffer/crawlengine-mcp) |
|
|
171
|
+
| **BrowserBridge MCP** | Deterministic headless browser automation with cryptographic action receipts | [GitHub](https://github.com/johannschiffer/browserbridge-mcp) |
|
|
172
|
+
| **PgSafe MCP** | Zero-trust PostgreSQL/SQLite guard, live PII masking, zero-downtime migration checks | [GitHub](https://github.com/johannschiffer/pgsafe-mcp) |
|
|
173
|
+
| **OmniBridge MCP** (this repo) | Multi-channel notification and webhook bus with a persistent SQLite WAL queue | [GitHub](https://github.com/johannschiffer/omnibridge-mcp) |
|
|
174
|
+
| **SysFlow MCP** | Safe Linux administration plane: systemd, port audit, isolated execution | [GitHub](https://github.com/johannschiffer/sysflow-mcp) |
|
|
175
|
+
| **FastMCP Forge** | Production MCP server scaffolder: stdio, SSE and auth middleware | [GitHub](https://github.com/johannschiffer/fastmcp-forge) |
|
|
176
|
+
|
|
177
|
+
[Live config builder](https://johannschiffer.github.io) | [Starter Kit, free](https://johanld.gumroad.com/l/genesis-starter-kit) | [Enterprise Suite, $19](https://johanld.gumroad.com/l/genesis-enterprise-suite)
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
"""Upgrade notice. Printed to stderr so MCP stdio traffic on stdout is never affected."""
|
|
2
|
+
import os
|
|
3
|
+
import sys
|
|
4
|
+
|
|
5
|
+
NOTICE = 'OmniBridge MCP (open edition). Starter Kit, free: https://johanld.gumroad.com/l/khffw | Enterprise Suite ($19): https://johanld.gumroad.com/l/tzuvz'
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
def print_upgrade_notice():
|
|
9
|
+
if os.environ.get("GENESIS_NO_NOTICE") == "1":
|
|
10
|
+
return
|
|
11
|
+
print(NOTICE, file=sys.stderr)
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Base channel interface for OmniBridge notification providers.
|
|
3
|
+
"""
|
|
4
|
+
from abc import ABC, abstractmethod
|
|
5
|
+
from typing import Dict, Any
|
|
6
|
+
|
|
7
|
+
class BaseChannel(ABC):
|
|
8
|
+
@property
|
|
9
|
+
@abstractmethod
|
|
10
|
+
def channel_name(self) -> str:
|
|
11
|
+
"""Unique identifier for channel."""
|
|
12
|
+
pass
|
|
13
|
+
|
|
14
|
+
@abstractmethod
|
|
15
|
+
def is_configured(self) -> bool:
|
|
16
|
+
"""Checks if required credentials/endpoints are set."""
|
|
17
|
+
pass
|
|
18
|
+
|
|
19
|
+
@abstractmethod
|
|
20
|
+
def send(self, **kwargs) -> Dict[str, Any]:
|
|
21
|
+
"""Synchronously or asynchronously dispatches notification."""
|
|
22
|
+
pass
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Discord Webhook notification channel provider.
|
|
3
|
+
"""
|
|
4
|
+
import os
|
|
5
|
+
from typing import Dict, Any, Optional
|
|
6
|
+
import httpx
|
|
7
|
+
from .base import BaseChannel
|
|
8
|
+
|
|
9
|
+
class DiscordChannel(BaseChannel):
|
|
10
|
+
channel_name = "discord"
|
|
11
|
+
|
|
12
|
+
def __init__(self, webhook_url: Optional[str] = None):
|
|
13
|
+
self.webhook_url = webhook_url or os.getenv("DISCORD_WEBHOOK_URL", "").strip()
|
|
14
|
+
|
|
15
|
+
def is_configured(self) -> bool:
|
|
16
|
+
return bool(self.webhook_url and self.webhook_url.startswith("https://discord.com/api/webhooks/"))
|
|
17
|
+
|
|
18
|
+
def send(self, content: str = "", username: str = "OmniBridge AI",
|
|
19
|
+
title: Optional[str] = None, description: Optional[str] = None,
|
|
20
|
+
color: int = 0x3498db, webhook_url: Optional[str] = None) -> Dict[str, Any]:
|
|
21
|
+
|
|
22
|
+
target_url = webhook_url or self.webhook_url
|
|
23
|
+
if not target_url:
|
|
24
|
+
return {
|
|
25
|
+
"success": False,
|
|
26
|
+
"error": "DISCORD_WEBHOOK_URL is not configured."
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
payload: Dict[str, Any] = {"username": username}
|
|
30
|
+
if content:
|
|
31
|
+
payload["content"] = content
|
|
32
|
+
|
|
33
|
+
if title or description:
|
|
34
|
+
embed = {
|
|
35
|
+
"title": title or "Notification",
|
|
36
|
+
"description": description or "",
|
|
37
|
+
"color": color
|
|
38
|
+
}
|
|
39
|
+
payload["embeds"] = [embed]
|
|
40
|
+
|
|
41
|
+
try:
|
|
42
|
+
with httpx.Client(timeout=10.0) as client:
|
|
43
|
+
resp = client.post(target_url, json=payload)
|
|
44
|
+
if resp.status_code in (200, 204):
|
|
45
|
+
return {
|
|
46
|
+
"success": True,
|
|
47
|
+
"channel": "discord",
|
|
48
|
+
"status_code": resp.status_code
|
|
49
|
+
}
|
|
50
|
+
else:
|
|
51
|
+
return {
|
|
52
|
+
"success": False,
|
|
53
|
+
"channel": "discord",
|
|
54
|
+
"status_code": resp.status_code,
|
|
55
|
+
"error": resp.text
|
|
56
|
+
}
|
|
57
|
+
except Exception as e:
|
|
58
|
+
return {
|
|
59
|
+
"success": False,
|
|
60
|
+
"channel": "discord",
|
|
61
|
+
"error": f"Discord request failed: {str(e)}"
|
|
62
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
"""
|
|
2
|
+
Telegram Bot notification channel provider.
|
|
3
|
+
"""
|
|
4
|
+
import os
|
|
5
|
+
from typing import Dict, Any, Optional
|
|
6
|
+
import httpx
|
|
7
|
+
from .base import BaseChannel
|
|
8
|
+
|
|
9
|
+
class TelegramChannel(BaseChannel):
|
|
10
|
+
channel_name = "telegram"
|
|
11
|
+
|
|
12
|
+
def __init__(self, bot_token: Optional[str] = None):
|
|
13
|
+
self.bot_token = bot_token or os.getenv("TELEGRAM_BOT_TOKEN", "").strip()
|
|
14
|
+
|
|
15
|
+
def is_configured(self) -> bool:
|
|
16
|
+
return bool(self.bot_token)
|
|
17
|
+
|
|
18
|
+
def send(self, chat_id: str, text: str, parse_mode: str = "Markdown", disable_notification: bool = False) -> Dict[str, Any]:
|
|
19
|
+
if not self.is_configured():
|
|
20
|
+
return {
|
|
21
|
+
"success": False,
|
|
22
|
+
"error": "TELEGRAM_BOT_TOKEN is not configured. Set environment variable or pass token."
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
url = f"https://api.telegram.org/bot{self.bot_token}/sendMessage"
|
|
26
|
+
payload = {
|
|
27
|
+
"chat_id": chat_id,
|
|
28
|
+
"text": text,
|
|
29
|
+
"parse_mode": parse_mode,
|
|
30
|
+
"disable_notification": disable_notification
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
try:
|
|
34
|
+
with httpx.Client(timeout=10.0) as client:
|
|
35
|
+
resp = client.post(url, json=payload)
|
|
36
|
+
data = resp.json()
|
|
37
|
+
if resp.status_code == 200 and data.get("ok"):
|
|
38
|
+
return {
|
|
39
|
+
"success": True,
|
|
40
|
+
"channel": "telegram",
|
|
41
|
+
"message_id": data.get("result", {}).get("message_id"),
|
|
42
|
+
"chat_id": chat_id
|
|
43
|
+
}
|
|
44
|
+
else:
|
|
45
|
+
return {
|
|
46
|
+
"success": False,
|
|
47
|
+
"channel": "telegram",
|
|
48
|
+
"error": data.get("description", resp.text),
|
|
49
|
+
"status_code": resp.status_code
|
|
50
|
+
}
|
|
51
|
+
except Exception as e:
|
|
52
|
+
return {
|
|
53
|
+
"success": False,
|
|
54
|
+
"channel": "telegram",
|
|
55
|
+
"error": f"Connection error: {str(e)}"
|
|
56
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
"""
|
|
2
|
+
OmniBridge CLI testing tool.
|
|
3
|
+
Usage:
|
|
4
|
+
python -m omnibridge.cli status
|
|
5
|
+
python -m omnibridge.cli test --channel discord --webhook <URL> --message "Hello from OmniBridge"
|
|
6
|
+
python -m omnibridge.cli test --channel telegram --token <TOKEN> --chat-id <ID> --message "Hello"
|
|
7
|
+
"""
|
|
8
|
+
|
|
9
|
+
import argparse
|
|
10
|
+
import json
|
|
11
|
+
import sys
|
|
12
|
+
from .channels import TelegramChannel, DiscordChannel
|
|
13
|
+
|
|
14
|
+
def main():
|
|
15
|
+
parser = argparse.ArgumentParser(description="OmniBridge CLI utility")
|
|
16
|
+
subparsers = parser.add_subparsers(dest="command", help="Sub-commands")
|
|
17
|
+
|
|
18
|
+
# Status command
|
|
19
|
+
subparsers.add_parser("status", help="Check channels configuration")
|
|
20
|
+
|
|
21
|
+
# Test command
|
|
22
|
+
test_parser = subparsers.add_parser("test", help="Send a test notification")
|
|
23
|
+
test_parser.add_argument("--channel", choices=["telegram", "discord"], required=True, help="Target channel")
|
|
24
|
+
test_parser.add_argument("--message", default="Test alert from OmniBridge CLI", help="Message to send")
|
|
25
|
+
test_parser.add_argument("--token", help="Telegram bot token (optional, falls back to env)")
|
|
26
|
+
test_parser.add_argument("--chat-id", help="Telegram chat ID")
|
|
27
|
+
test_parser.add_argument("--webhook", help="Discord webhook URL (optional, falls back to env)")
|
|
28
|
+
|
|
29
|
+
args = parser.parse_args()
|
|
30
|
+
|
|
31
|
+
if args.command == "status":
|
|
32
|
+
tg = TelegramChannel()
|
|
33
|
+
dc = DiscordChannel()
|
|
34
|
+
status = {
|
|
35
|
+
"telegram": {"configured": tg.is_configured()},
|
|
36
|
+
"discord": {"configured": dc.is_configured()}
|
|
37
|
+
}
|
|
38
|
+
print(json.dumps(status, indent=2))
|
|
39
|
+
|
|
40
|
+
elif args.command == "test":
|
|
41
|
+
if args.channel == "telegram":
|
|
42
|
+
if not args.chat_id:
|
|
43
|
+
print("Error: --chat-id is required for telegram test", file=sys.stderr)
|
|
44
|
+
sys.exit(1)
|
|
45
|
+
tg = TelegramChannel(bot_token=args.token)
|
|
46
|
+
res = tg.send(chat_id=args.chat_id, text=args.message)
|
|
47
|
+
print(json.dumps(res, indent=2))
|
|
48
|
+
|
|
49
|
+
elif args.channel == "discord":
|
|
50
|
+
dc = DiscordChannel(webhook_url=args.webhook)
|
|
51
|
+
res = dc.send(title="OmniBridge Test", description=args.message)
|
|
52
|
+
print(json.dumps(res, indent=2))
|
|
53
|
+
|
|
54
|
+
else:
|
|
55
|
+
parser.print_help()
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
_main_impl = main
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
def main():
|
|
63
|
+
from ._genesis import print_upgrade_notice
|
|
64
|
+
try:
|
|
65
|
+
return _main_impl()
|
|
66
|
+
finally:
|
|
67
|
+
print_upgrade_notice()
|
|
68
|
+
|
|
69
|
+
if __name__ == "__main__":
|
|
70
|
+
main()
|
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
"""
|
|
2
|
+
OmniBridge MCP: Model Context Protocol Server (Lite Edition)
|
|
3
|
+
Implements standard JSON-RPC 2.0 stdio transport compatible with
|
|
4
|
+
Claude Desktop, Cursor, Zed, Windsurf, and Antigravity.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
import sys
|
|
8
|
+
import json
|
|
9
|
+
import logging
|
|
10
|
+
from typing import Dict, Any, List
|
|
11
|
+
from .channels import TelegramChannel, DiscordChannel
|
|
12
|
+
|
|
13
|
+
# Configure logging to stderr so stdout remains purely JSON-RPC messages
|
|
14
|
+
logging.basicConfig(
|
|
15
|
+
level=logging.INFO,
|
|
16
|
+
format="%(asctime)s [%(levelname)s] [OmniBridge] %(message)s",
|
|
17
|
+
stream=sys.stderr
|
|
18
|
+
)
|
|
19
|
+
logger = logging.getLogger("OmniBridgeServer")
|
|
20
|
+
|
|
21
|
+
class OmniBridgeMCPServer:
|
|
22
|
+
def __init__(self):
|
|
23
|
+
self.telegram = TelegramChannel()
|
|
24
|
+
self.discord = DiscordChannel()
|
|
25
|
+
self.server_name = "omnibridge-mcp"
|
|
26
|
+
self.server_version = "1.0.0"
|
|
27
|
+
|
|
28
|
+
def get_tools_definition(self) -> List[Dict[str, Any]]:
|
|
29
|
+
return [
|
|
30
|
+
{
|
|
31
|
+
"name": "send_telegram_message",
|
|
32
|
+
"description": "Send a real-time notification or message to a Telegram chat, user, or channel.",
|
|
33
|
+
"inputSchema": {
|
|
34
|
+
"type": "object",
|
|
35
|
+
"properties": {
|
|
36
|
+
"chat_id": {
|
|
37
|
+
"type": "string",
|
|
38
|
+
"description": "Telegram chat ID, user ID or @channelusername"
|
|
39
|
+
},
|
|
40
|
+
"text": {
|
|
41
|
+
"type": "string",
|
|
42
|
+
"description": "Message body to send (supports Markdown)"
|
|
43
|
+
},
|
|
44
|
+
"disable_notification": {
|
|
45
|
+
"type": "boolean",
|
|
46
|
+
"description": "Send silently without sound alert (default: false)"
|
|
47
|
+
}
|
|
48
|
+
},
|
|
49
|
+
"required": ["chat_id", "text"]
|
|
50
|
+
}
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
"name": "send_discord_alert",
|
|
54
|
+
"description": "Send a rich webhook notification or embed to a Discord channel.",
|
|
55
|
+
"inputSchema": {
|
|
56
|
+
"type": "object",
|
|
57
|
+
"properties": {
|
|
58
|
+
"content": {
|
|
59
|
+
"type": "string",
|
|
60
|
+
"description": "Optional raw text message"
|
|
61
|
+
},
|
|
62
|
+
"title": {
|
|
63
|
+
"type": "string",
|
|
64
|
+
"description": "Embed card title"
|
|
65
|
+
},
|
|
66
|
+
"description": {
|
|
67
|
+
"type": "string",
|
|
68
|
+
"description": "Embed card detailed description or body"
|
|
69
|
+
},
|
|
70
|
+
"color": {
|
|
71
|
+
"type": "integer",
|
|
72
|
+
"description": "Hex decimal color code (default: 3447003 / 0x3498db Blue, 0x2ecc71 Green, 0xe74c3c Red)"
|
|
73
|
+
},
|
|
74
|
+
"webhook_url": {
|
|
75
|
+
"type": "string",
|
|
76
|
+
"description": "Optional target Discord webhook URL if overriding default"
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"name": "get_channel_status",
|
|
83
|
+
"description": "Check configuration and operational readiness of all connected notification channels.",
|
|
84
|
+
"inputSchema": {
|
|
85
|
+
"type": "object",
|
|
86
|
+
"properties": {}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
]
|
|
90
|
+
|
|
91
|
+
def handle_tool_call(self, name: str, arguments: Dict[str, Any]) -> Dict[str, Any]:
|
|
92
|
+
if name == "send_telegram_message":
|
|
93
|
+
chat_id = arguments.get("chat_id", "")
|
|
94
|
+
text = arguments.get("text", "")
|
|
95
|
+
disable_notification = arguments.get("disable_notification", False)
|
|
96
|
+
res = self.telegram.send(chat_id=chat_id, text=text, disable_notification=disable_notification)
|
|
97
|
+
return res
|
|
98
|
+
|
|
99
|
+
elif name == "send_discord_alert":
|
|
100
|
+
res = self.discord.send(
|
|
101
|
+
content=arguments.get("content", ""),
|
|
102
|
+
title=arguments.get("title"),
|
|
103
|
+
description=arguments.get("description"),
|
|
104
|
+
color=arguments.get("color", 0x3498db),
|
|
105
|
+
webhook_url=arguments.get("webhook_url")
|
|
106
|
+
)
|
|
107
|
+
return res
|
|
108
|
+
|
|
109
|
+
elif name == "get_channel_status":
|
|
110
|
+
return {
|
|
111
|
+
"edition": "Lite (Open-Source)",
|
|
112
|
+
"channels": {
|
|
113
|
+
"telegram": {
|
|
114
|
+
"configured": self.telegram.is_configured(),
|
|
115
|
+
"bot_token_set": bool(self.telegram.bot_token)
|
|
116
|
+
},
|
|
117
|
+
"discord": {
|
|
118
|
+
"configured": self.discord.is_configured(),
|
|
119
|
+
"webhook_set": bool(self.discord.webhook_url)
|
|
120
|
+
},
|
|
121
|
+
"whatsapp": {
|
|
122
|
+
"configured": False,
|
|
123
|
+
"note": "Available in OmniBridge Pro ($14.99): WhatsApp Cloud API, Slack BlockKit, Matrix, and Resilient WAL Queue"
|
|
124
|
+
},
|
|
125
|
+
"slack": {
|
|
126
|
+
"configured": False,
|
|
127
|
+
"note": "Available in OmniBridge Pro ($14.99)"
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
else:
|
|
132
|
+
raise ValueError(f"Unknown tool: {name}")
|
|
133
|
+
|
|
134
|
+
def handle_request(self, request: Dict[str, Any]) -> Optional[Dict[str, Any]]:
|
|
135
|
+
req_id = request.get("id")
|
|
136
|
+
method = request.get("method")
|
|
137
|
+
params = request.get("params", {})
|
|
138
|
+
|
|
139
|
+
# Handle notifications (no response needed)
|
|
140
|
+
if req_id is None:
|
|
141
|
+
if method == "notifications/initialized":
|
|
142
|
+
logger.info("Client completed initialization handshake.")
|
|
143
|
+
return None
|
|
144
|
+
|
|
145
|
+
# 1. Initialize
|
|
146
|
+
if method == "initialize":
|
|
147
|
+
return {
|
|
148
|
+
"jsonrpc": "2.0",
|
|
149
|
+
"id": req_id,
|
|
150
|
+
"result": {
|
|
151
|
+
"protocolVersion": "2024-11-05",
|
|
152
|
+
"capabilities": {
|
|
153
|
+
"tools": {}
|
|
154
|
+
},
|
|
155
|
+
"serverInfo": {
|
|
156
|
+
"name": self.server_name,
|
|
157
|
+
"version": self.server_version
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
# 2. Ping
|
|
163
|
+
elif method == "ping":
|
|
164
|
+
return {
|
|
165
|
+
"jsonrpc": "2.0",
|
|
166
|
+
"id": req_id,
|
|
167
|
+
"result": {}
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
# 3. List tools
|
|
171
|
+
elif method == "tools/list":
|
|
172
|
+
return {
|
|
173
|
+
"jsonrpc": "2.0",
|
|
174
|
+
"id": req_id,
|
|
175
|
+
"result": {
|
|
176
|
+
"tools": self.get_tools_definition()
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
# 4. Call tool
|
|
181
|
+
elif method == "tools/call":
|
|
182
|
+
tool_name = params.get("name")
|
|
183
|
+
tool_args = params.get("arguments", {})
|
|
184
|
+
try:
|
|
185
|
+
output = self.handle_tool_call(tool_name, tool_args)
|
|
186
|
+
return {
|
|
187
|
+
"jsonrpc": "2.0",
|
|
188
|
+
"id": req_id,
|
|
189
|
+
"result": {
|
|
190
|
+
"content": [
|
|
191
|
+
{
|
|
192
|
+
"type": "text",
|
|
193
|
+
"text": json.dumps(output, indent=2, ensure_ascii=False)
|
|
194
|
+
}
|
|
195
|
+
],
|
|
196
|
+
"isError": not output.get("success", True) if "success" in output else False
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
except Exception as e:
|
|
200
|
+
logger.error(f"Error calling tool {tool_name}: {e}")
|
|
201
|
+
return {
|
|
202
|
+
"jsonrpc": "2.0",
|
|
203
|
+
"id": req_id,
|
|
204
|
+
"error": {
|
|
205
|
+
"code": -32000,
|
|
206
|
+
"message": str(e)
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
else:
|
|
211
|
+
return {
|
|
212
|
+
"jsonrpc": "2.0",
|
|
213
|
+
"id": req_id,
|
|
214
|
+
"error": {
|
|
215
|
+
"code": -32601,
|
|
216
|
+
"message": f"Method not found: {method}"
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
def run_stdio(self):
|
|
221
|
+
"""Standard IO event loop reading JSON-RPC lines from stdin and writing to stdout."""
|
|
222
|
+
logger.info(f"Starting {self.server_name} v{self.server_version} stdio listener...")
|
|
223
|
+
for line in sys.stdin:
|
|
224
|
+
line = line.strip()
|
|
225
|
+
if not line:
|
|
226
|
+
continue
|
|
227
|
+
try:
|
|
228
|
+
request = json.loads(line)
|
|
229
|
+
response = self.handle_request(request)
|
|
230
|
+
if response is not None:
|
|
231
|
+
sys.stdout.write(json.dumps(response) + "\n")
|
|
232
|
+
sys.stdout.flush()
|
|
233
|
+
except json.JSONDecodeError as e:
|
|
234
|
+
logger.error(f"Malformed JSON: {e}")
|
|
235
|
+
err_resp = {
|
|
236
|
+
"jsonrpc": "2.0",
|
|
237
|
+
"id": None,
|
|
238
|
+
"error": {"code": -32700, "message": "Parse error"}
|
|
239
|
+
}
|
|
240
|
+
sys.stdout.write(json.dumps(err_resp) + "\n")
|
|
241
|
+
sys.stdout.flush()
|
|
242
|
+
except Exception as e:
|
|
243
|
+
logger.error(f"Unexpected error: {e}")
|
|
244
|
+
|
|
245
|
+
def main():
|
|
246
|
+
import argparse
|
|
247
|
+
parser = argparse.ArgumentParser(
|
|
248
|
+
prog="omnibridge-mcp",
|
|
249
|
+
description="OmniBridge MCP: Resilient Multi-Channel Notification and Webhook Server for AI Agents"
|
|
250
|
+
)
|
|
251
|
+
parser.add_argument("-v", "--version", action="version", version="%(prog)s 1.0.0")
|
|
252
|
+
args, unknown = parser.parse_known_args()
|
|
253
|
+
server = OmniBridgeMCPServer()
|
|
254
|
+
server.run_stdio()
|
|
255
|
+
|
|
256
|
+
if __name__ == "__main__":
|
|
257
|
+
main()
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: omnibridge-mcp
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: Lightweight, resilient multi-channel notification and webhook MCP server for AI agents
|
|
5
|
+
Author: Johann Schiffer
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://johannschiffer.github.io
|
|
8
|
+
Project-URL: Repository, https://github.com/johannschiffer/omnibridge-mcp
|
|
9
|
+
Project-URL: Starter Kit, https://johanld.gumroad.com/l/genesis-starter-kit
|
|
10
|
+
Project-URL: Enterprise Suite, https://johanld.gumroad.com/l/genesis-enterprise-suite
|
|
11
|
+
Keywords: mcp,model-context-protocol,claude,cursor,telegram,discord,notifications,ai-agent
|
|
12
|
+
Requires-Python: >=3.10
|
|
13
|
+
Description-Content-Type: text/markdown
|
|
14
|
+
License-File: LICENSE
|
|
15
|
+
Requires-Dist: httpx>=0.25.0
|
|
16
|
+
Provides-Extra: test
|
|
17
|
+
Requires-Dist: pytest>=7; extra == "test"
|
|
18
|
+
Dynamic: license-file
|
|
19
|
+
|
|
20
|
+
# OmniBridge MCP (Lite Edition)
|
|
21
|
+
|
|
22
|
+
<a href="https://glama.ai/mcp/servers/@johannschiffer/omnibridge-mcp">
|
|
23
|
+
<img width="380" height="200" src="https://glama.ai/mcp/servers/@johannschiffer/omnibridge-mcp/badge" alt="omnibridge-mcp MCP server" />
|
|
24
|
+
</a>
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
> **Free:** [Genesis Starter Kit](https://johanld.gumroad.com/l/genesis-starter-kit) (25 `.cursorrules`/`CLAUDE.md` rulesets + MCP configs). Try the [live config builder](https://johannschiffer.github.io).
|
|
28
|
+
> **Full stack:** all six servers in [Genesis Enterprise Suite ($19)](https://johanld.gumroad.com/l/genesis-enterprise-suite).
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
[](LICENSE)
|
|
32
|
+
[](https://python.org)
|
|
33
|
+
[](https://modelcontextprotocol.io)
|
|
34
|
+
|
|
35
|
+
**OmniBridge MCP** is a lightweight, zero-latency Model Context Protocol server that gives AI agents (in **Claude Desktop**, **Cursor**, **Windsurf**, and **Antigravity**) direct, controlled access to send real-time alerts, operational notifications, and webhooks without exposing your primary API keys or relying on bloated middleware.
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Run without cloning
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
uvx --from git+https://github.com/johannschiffer/omnibridge-mcp omnibridge-mcp
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Claude Desktop / Cursor config entry:
|
|
46
|
+
|
|
47
|
+
```json
|
|
48
|
+
{
|
|
49
|
+
"mcpServers": {
|
|
50
|
+
"omnibridge-mcp": {
|
|
51
|
+
"command": "uvx",
|
|
52
|
+
"args": [
|
|
53
|
+
"--from",
|
|
54
|
+
"git+https://github.com/johannschiffer/omnibridge-mcp",
|
|
55
|
+
"omnibridge-mcp"
|
|
56
|
+
]
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
[](https://github.com/johannschiffer/omnibridge-mcp/actions/workflows/ci.yml)
|
|
63
|
+
|
|
64
|
+
## โก Key Features (Lite Edition)
|
|
65
|
+
|
|
66
|
+
- ๐ **Zero Heavy Dependencies**: Pure Python implementation with minimal footprint (`httpx`).
|
|
67
|
+
- ๐ฌ **Telegram Bot API**: Send markdown-formatted alerts, silent notifications, and direct messages.
|
|
68
|
+
- ๐ฎ **Discord Webhooks**: Send rich embed cards with custom colors, titles, and timestamps.
|
|
69
|
+
- ๐ **Universal Compatibility**: Works out of the box with any MCP-compliant client via standard IO (`stdio`).
|
|
70
|
+
- ๐งช **Built-in CLI**: Interactive test tool to verify credentials and channel delivery in seconds.
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## ๐ Quick Setup in 2 Minutes
|
|
75
|
+
|
|
76
|
+
### 1. Installation
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
git clone https://github.com/johannschiffer/omnibridge-mcp.git
|
|
80
|
+
cd omnibridge-mcp
|
|
81
|
+
pip install -r requirements.txt
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### 2. Environment Variables
|
|
85
|
+
|
|
86
|
+
Create a `.env` file or export variables in your shell:
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
# Telegram Bot Token (from @BotFather)
|
|
90
|
+
export TELEGRAM_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ"
|
|
91
|
+
|
|
92
|
+
# Discord Webhook URL (from Channel Settings -> Integrations -> Webhooks)
|
|
93
|
+
export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
### 3. Verify with CLI
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
# Check channels configuration
|
|
100
|
+
python -m omnibridge.cli status
|
|
101
|
+
|
|
102
|
+
# Send a test alert to Discord
|
|
103
|
+
python -m omnibridge.cli test --channel discord --message "OmniBridge is live!"
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## ๐ฅ๏ธ Client Configuration
|
|
109
|
+
|
|
110
|
+
### Claude Desktop (`claude_desktop_config.json`)
|
|
111
|
+
|
|
112
|
+
On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
113
|
+
On Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
114
|
+
On Linux: `~/.config/Claude/claude_desktop_config.json`
|
|
115
|
+
|
|
116
|
+
```json
|
|
117
|
+
{
|
|
118
|
+
"mcpServers": {
|
|
119
|
+
"omnibridge": {
|
|
120
|
+
"command": "python",
|
|
121
|
+
"args": ["-m", "omnibridge.server"],
|
|
122
|
+
"cwd": "/path/to/omnibridge-mcp",
|
|
123
|
+
"env": {
|
|
124
|
+
"TELEGRAM_BOT_TOKEN": "your_bot_token_here",
|
|
125
|
+
"DISCORD_WEBHOOK_URL": "your_discord_webhook_url_here"
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
### Cursor (`.cursor/mcp.json`)
|
|
133
|
+
|
|
134
|
+
```json
|
|
135
|
+
{
|
|
136
|
+
"mcpServers": {
|
|
137
|
+
"omnibridge": {
|
|
138
|
+
"command": "python -m omnibridge.server",
|
|
139
|
+
"env": {
|
|
140
|
+
"TELEGRAM_BOT_TOKEN": "your_bot_token_here",
|
|
141
|
+
"DISCORD_WEBHOOK_URL": "your_discord_webhook_url_here"
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## ๐ ๏ธ MCP Tools Available
|
|
151
|
+
|
|
152
|
+
| Tool | Parameters | Description |
|
|
153
|
+
|---|---|---|
|
|
154
|
+
| `send_telegram_message` | `chat_id`, `text`, `disable_notification` | Sends Telegram notification with Markdown support |
|
|
155
|
+
| `send_discord_alert` | `content`, `title`, `description`, `color`, `webhook_url` | Sends Discord rich embed card |
|
|
156
|
+
| `get_channel_status` | *(none)* | Returns connectivity and health of all channels |
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## ๐ Need Enterprise Features? Upgrade to OmniBridge Pro
|
|
161
|
+
|
|
162
|
+
Looking for production-grade reliability, business messaging, and fault tolerance?
|
|
163
|
+
|
|
164
|
+
| Feature | Lite (Open Source) | Enterprise Suite ($19) |
|
|
165
|
+
|---|:---:|:---:|
|
|
166
|
+
| **Telegram Bot API** | โ
| โ
|
|
|
167
|
+
| **Discord Webhooks** | โ
| โ
|
|
|
168
|
+
| **WhatsApp Cloud API** | โ | โ
|
|
|
169
|
+
| **Slack Block Kit & Webhooks** | โ | โ
|
|
|
170
|
+
| **Matrix Protocol Rooms** | โ | โ
|
|
|
171
|
+
| **Custom Webhooks with HMAC** | โ | โ
|
|
|
172
|
+
| **Offline WAL Resilient Queue** *(Zero Message Loss)* | โ | โ
|
|
|
173
|
+
| **Adaptive Rate Limiting** *(Anti-ban protection)* | โ | โ
|
|
|
174
|
+
| **Production Docker & Compose** | โ | โ
|
|
|
175
|
+
| **Full Pytest Suite & Architecture PDF** | โ | โ
|
|
|
176
|
+
|
|
177
|
+
๐ **[Get the Genesis Enterprise Suite ($19)](https://johanld.gumroad.com/l/genesis-enterprise-suite)**
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
## ๐ License
|
|
182
|
+
|
|
183
|
+
MIT License. See [LICENSE](LICENSE) for details.
|
|
184
|
+
|
|
185
|
+
## Genesis MCP Ecosystem
|
|
186
|
+
|
|
187
|
+
| Module | What it does | Repo |
|
|
188
|
+
|---|---|---|
|
|
189
|
+
| **CrawlEngine MCP** | Anti-bot web scraping, clean Markdown, proxy rotation and TLS evasion | [GitHub](https://github.com/johannschiffer/crawlengine-mcp) |
|
|
190
|
+
| **BrowserBridge MCP** | Deterministic headless browser automation with cryptographic action receipts | [GitHub](https://github.com/johannschiffer/browserbridge-mcp) |
|
|
191
|
+
| **PgSafe MCP** | Zero-trust PostgreSQL/SQLite guard, live PII masking, zero-downtime migration checks | [GitHub](https://github.com/johannschiffer/pgsafe-mcp) |
|
|
192
|
+
| **OmniBridge MCP** (this repo) | Multi-channel notification and webhook bus with a persistent SQLite WAL queue | [GitHub](https://github.com/johannschiffer/omnibridge-mcp) |
|
|
193
|
+
| **SysFlow MCP** | Safe Linux administration plane: systemd, port audit, isolated execution | [GitHub](https://github.com/johannschiffer/sysflow-mcp) |
|
|
194
|
+
| **FastMCP Forge** | Production MCP server scaffolder: stdio, SSE and auth middleware | [GitHub](https://github.com/johannschiffer/fastmcp-forge) |
|
|
195
|
+
|
|
196
|
+
[Live config builder](https://johannschiffer.github.io) | [Starter Kit, free](https://johanld.gumroad.com/l/genesis-starter-kit) | [Enterprise Suite, $19](https://johanld.gumroad.com/l/genesis-enterprise-suite)
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
LICENSE
|
|
2
|
+
README.md
|
|
3
|
+
pyproject.toml
|
|
4
|
+
omnibridge/__init__.py
|
|
5
|
+
omnibridge/_genesis.py
|
|
6
|
+
omnibridge/cli.py
|
|
7
|
+
omnibridge/server.py
|
|
8
|
+
omnibridge/channels/__init__.py
|
|
9
|
+
omnibridge/channels/base.py
|
|
10
|
+
omnibridge/channels/discord.py
|
|
11
|
+
omnibridge/channels/telegram.py
|
|
12
|
+
omnibridge_mcp.egg-info/PKG-INFO
|
|
13
|
+
omnibridge_mcp.egg-info/SOURCES.txt
|
|
14
|
+
omnibridge_mcp.egg-info/dependency_links.txt
|
|
15
|
+
omnibridge_mcp.egg-info/entry_points.txt
|
|
16
|
+
omnibridge_mcp.egg-info/requires.txt
|
|
17
|
+
omnibridge_mcp.egg-info/top_level.txt
|
|
18
|
+
tests/test_genesis_entrypoints.py
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
omnibridge
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=61.0"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "omnibridge-mcp"
|
|
7
|
+
version = "1.0.0"
|
|
8
|
+
description = "Lightweight, resilient multi-channel notification and webhook MCP server for AI agents"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.10"
|
|
11
|
+
license = {text = "MIT"}
|
|
12
|
+
authors = [
|
|
13
|
+
{name = "Johann Schiffer"}
|
|
14
|
+
]
|
|
15
|
+
keywords = ["mcp", "model-context-protocol", "claude", "cursor", "telegram", "discord", "notifications", "ai-agent"]
|
|
16
|
+
dependencies = [
|
|
17
|
+
"httpx>=0.25.0"
|
|
18
|
+
]
|
|
19
|
+
|
|
20
|
+
[project.optional-dependencies]
|
|
21
|
+
test = ["pytest>=7"]
|
|
22
|
+
|
|
23
|
+
[project.scripts]
|
|
24
|
+
omnibridge-mcp = "omnibridge.server:main"
|
|
25
|
+
omnibridge-cli = "omnibridge.cli:main"
|
|
26
|
+
|
|
27
|
+
[tool.setuptools.packages.find]
|
|
28
|
+
include = ["omnibridge*"]
|
|
29
|
+
|
|
30
|
+
[project.urls]
|
|
31
|
+
Homepage = "https://johannschiffer.github.io"
|
|
32
|
+
Repository = "https://github.com/johannschiffer/omnibridge-mcp"
|
|
33
|
+
"Starter Kit" = "https://johanld.gumroad.com/l/genesis-starter-kit"
|
|
34
|
+
"Enterprise Suite" = "https://johanld.gumroad.com/l/genesis-enterprise-suite"
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import importlib
|
|
2
|
+
import io
|
|
3
|
+
import os
|
|
4
|
+
import sys
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def test_script_target_is_callable():
|
|
8
|
+
mod = importlib.import_module('omnibridge.server')
|
|
9
|
+
assert callable(getattr(mod, 'main'))
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def test_upgrade_notice_goes_to_stderr(capsys, monkeypatch):
|
|
13
|
+
monkeypatch.delenv('GENESIS_NO_NOTICE', raising=False)
|
|
14
|
+
from omnibridge._genesis import print_upgrade_notice
|
|
15
|
+
print_upgrade_notice()
|
|
16
|
+
out = capsys.readouterr()
|
|
17
|
+
assert out.out == ''
|
|
18
|
+
assert 'gumroad.com' in out.err
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def test_upgrade_notice_can_be_silenced(capsys, monkeypatch):
|
|
22
|
+
monkeypatch.setenv('GENESIS_NO_NOTICE', '1')
|
|
23
|
+
from omnibridge._genesis import print_upgrade_notice
|
|
24
|
+
print_upgrade_notice()
|
|
25
|
+
assert capsys.readouterr().err == ''
|