# BuboBot MCP Server
A Model Context Protocol (MCP) server to retrieve monitoring, incident, notification and other data from Bubobot services.
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
## What is BuboBot MCP?
BuboBot MCP is a server implementation of the Model Context Protocol that enables AI models to access and retrieve data from Bubobot monitoring services. It provides a standardized interface for:
- 📊 **System Monitoring Data** - Retrieve metrics, alerts, and system status
- 🚨 **Incident Management** - Access incident reports, status updates, and resolution data
- 📢 **Notifications** - Fetch notification history and delivery status
- 🔧 **Service Information** - Get service configurations and health checks
## Installation
```bash
pip install bubobot-mcp
```
## Quick Start
### For Claude Desktop Integration
Add to your Claude Desktop configuration (`claude_desktop_config.json`):
```json
# Default stdio transport
{
"mcpServers": {
"bubobot-mcp": {
"command": "python",
"args": ["-m", "bubobot_mcp"],
"env": {
"BEARER_TOKEN": "your-bearer_token"
}
}
}
}
```
### For Development
```python
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
from mcp.client.streamable_http import streamablehttp_client
# Connect via stdio transport
server_params = StdioServerParameters(
command="python",
args=["-m", "bubobot_mcp"],
env={"BEARER_TOKEN": "your-bearer_token"}
)
# Or connect via HTTP to running server
http_transport = await streamablehttp_client(
"http://localhost:8000/mcp",
headers={"authorization": "your-bearer_token"}
)
```
## Features
- ✅ **MCP Compliant** - Full Model Context Protocol support
- ⚡ **Async Architecture** - High-performance async/await implementation
- 🔌 **Multiple Transports** - Supports stdio and HTTP transports
- 🛠️ **Configurable** - Flexible configuration via files or environment variables
- 📝 **Comprehensive Logging** - Detailed logging with customizable levels
- 🔒 **Secure** - Built-in authentication and error handling
## Requirements
- Python 3.10 or higher
- Valid Bubobot API credentials
- Network access to Bubobot services
## License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/bubobot/bubobot-mcp/blob/main/LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "bubobot-mcp",
"maintainer": "BuboBot Team",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "mcp, model-context-protocol, ai, monitoring, incident-management, system-tools, async, server",
"author": "BuboBot Team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/03/f3/eda2da3a3b82dcf6a3520d7494ac3695021fd9c27bc8256fe7b4b268c08e/bubobot_mcp-0.0.2.tar.gz",
"platform": null,
"description": "# BuboBot MCP Server\r\n\r\nA Model Context Protocol (MCP) server to retrieve monitoring, incident, notification and other data from Bubobot services.\r\n\r\n[](https://www.python.org/downloads/)\r\n[](https://opensource.org/licenses/MIT)\r\n\r\n## What is BuboBot MCP?\r\n\r\nBuboBot MCP is a server implementation of the Model Context Protocol that enables AI models to access and retrieve data from Bubobot monitoring services. It provides a standardized interface for:\r\n\r\n- \ud83d\udcca **System Monitoring Data** - Retrieve metrics, alerts, and system status\r\n- \ud83d\udea8 **Incident Management** - Access incident reports, status updates, and resolution data \r\n- \ud83d\udce2 **Notifications** - Fetch notification history and delivery status\r\n- \ud83d\udd27 **Service Information** - Get service configurations and health checks\r\n\r\n## Installation\r\n\r\n```bash\r\npip install bubobot-mcp\r\n```\r\n\r\n## Quick Start\r\n\r\n### For Claude Desktop Integration\r\n\r\nAdd to your Claude Desktop configuration (`claude_desktop_config.json`):\r\n\r\n```json\r\n# Default stdio transport\r\n{\r\n \"mcpServers\": {\r\n \"bubobot-mcp\": {\r\n \"command\": \"python\",\r\n \"args\": [\"-m\", \"bubobot_mcp\"],\r\n \"env\": {\r\n \"BEARER_TOKEN\": \"your-bearer_token\"\r\n }\r\n }\r\n }\r\n}\r\n```\r\n\r\n### For Development\r\n\r\n```python\r\nfrom mcp import ClientSession, StdioServerParameters\r\nfrom mcp.client.stdio import stdio_client\r\nfrom mcp.client.streamable_http import streamablehttp_client\r\n\r\n# Connect via stdio transport\r\nserver_params = StdioServerParameters(\r\n command=\"python\", \r\n args=[\"-m\", \"bubobot_mcp\"],\r\n env={\"BEARER_TOKEN\": \"your-bearer_token\"}\r\n)\r\n\r\n\r\n# Or connect via HTTP to running server\r\nhttp_transport = await streamablehttp_client(\r\n \"http://localhost:8000/mcp\",\r\n headers={\"authorization\": \"your-bearer_token\"}\r\n)\r\n\r\n```\r\n\r\n\r\n\r\n## Features\r\n\r\n- \u2705 **MCP Compliant** - Full Model Context Protocol support\r\n- \u26a1 **Async Architecture** - High-performance async/await implementation\r\n- \ud83d\udd0c **Multiple Transports** - Supports stdio and HTTP transports\r\n- \ud83d\udee0\ufe0f **Configurable** - Flexible configuration via files or environment variables\r\n- \ud83d\udcdd **Comprehensive Logging** - Detailed logging with customizable levels\r\n- \ud83d\udd12 **Secure** - Built-in authentication and error handling\r\n\r\n## Requirements\r\n\r\n- Python 3.10 or higher\r\n- Valid Bubobot API credentials\r\n- Network access to Bubobot services\r\n\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/bubobot/bubobot-mcp/blob/main/LICENSE) file for details. \r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Model Context Protocol (MCP) server to retrieve monitoring, incident, notification and other data from Bubobot services",
"version": "0.0.2",
"project_urls": {
"Bug Tracker": "https://github.com/bubobot/bubobot-mcp/issues",
"Changelog": "https://github.com/bubobot/bubobot-mcp/blob/main/CHANGELOG.md",
"Documentation": "https://bubobot-mcp.readthedocs.io/",
"Homepage": "https://github.com/bubobot/bubobot-mcp",
"Repository": "https://github.com/bubobot/bubobot-mcp.git"
},
"split_keywords": [
"mcp",
" model-context-protocol",
" ai",
" monitoring",
" incident-management",
" system-tools",
" async",
" server"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cc5a1db0a044312b0a2ee7ec3fbe4fe6800447921a84d83b3ce931ac74f846f4",
"md5": "75946f3a782eca8d765db62d69066737",
"sha256": "fef6a0c790844057d5246559fe386ccf84b7fa0d141dd89b0d492c178be819c6"
},
"downloads": -1,
"filename": "bubobot_mcp-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "75946f3a782eca8d765db62d69066737",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 44846,
"upload_time": "2025-07-20T05:43:04",
"upload_time_iso_8601": "2025-07-20T05:43:04.414878Z",
"url": "https://files.pythonhosted.org/packages/cc/5a/1db0a044312b0a2ee7ec3fbe4fe6800447921a84d83b3ce931ac74f846f4/bubobot_mcp-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "03f3eda2da3a3b82dcf6a3520d7494ac3695021fd9c27bc8256fe7b4b268c08e",
"md5": "b1e1979c5f3b50653a571396e3c6cd25",
"sha256": "a1eb82c43c41764966bfc277d3897c748074340d797bef0e7a7a9313845e0acd"
},
"downloads": -1,
"filename": "bubobot_mcp-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "b1e1979c5f3b50653a571396e3c6cd25",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 40548,
"upload_time": "2025-07-20T05:43:06",
"upload_time_iso_8601": "2025-07-20T05:43:06.364920Z",
"url": "https://files.pythonhosted.org/packages/03/f3/eda2da3a3b82dcf6a3520d7494ac3695021fd9c27bc8256fe7b4b268c08e/bubobot_mcp-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-20 05:43:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bubobot",
"github_project": "bubobot-mcp",
"github_not_found": true,
"lcname": "bubobot-mcp"
}