suprema-biostar-mcp 1.0.1__py3-none-any.whl

suprema_biostar_mcp-1.0.1.dist-info/METADATA

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: suprema-biostar-mcp
+Version: 1.0.1
+Summary: MCP Server for Suprema BioStar X - Access Control System Integration for AI Assistants
+Project-URL: Homepage, https://www.supremainc.com
+Project-URL: Documentation, https://docs.supremainc.com/en/platform/biostar_x
+Project-URL: Repository, https://github.com/anthropics/mcp-servers
+Author-email: "Suprema Inc." <support@supremainc.com>
+License: MIT
+License-File: LICENSE
+Keywords: access-control,ai-assistant,biostar,claude,mcp,security,suprema
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0.1
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Suprema BioStar MCP Server
+
+MCP (Model Context Protocol) server for **Suprema BioStar X** - Next-generation access control platform integration for AI assistants.
+
+> **🚀 One-Click Installation**: `uvx suprema-biostar-mcp`
+
+## Features
+
+- **129+ Tools**: Full BioStar X API coverage (users, doors, devices, access control, events, and more)
+- **Lightweight**: No heavy ML dependencies (~50MB vs 900MB)
+- **Live Documentation**: Real-time docs from docs.supremainc.com
+- **Multi-language**: Korean and English support
+- **Easy Setup**: Works with Claude Desktop, Claude Code, and any MCP client
+
+## Quick Start
+
+### 1. Add to Claude Desktop
+
+Edit your Claude Desktop config file:
+
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "suprema-biostar": {
+      "command": "uvx",
+      "args": ["suprema-biostar-mcp"],
+      "env": {
+        "BIOSTAR_URL": "https://your-biostar-server.com",
+        "BIOSTAR_USERNAME": "admin",
+        "BIOSTAR_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+### 2. Restart Claude Desktop
+
+That's it! 🎉
+
+## Configuration
+
+| Environment Variable | Required | Description |
+|---------------------|----------|-------------|
+| `BIOSTAR_URL` | ✅ | BioStar X server URL (e.g., `https://192.168.1.100`) |
+| `BIOSTAR_USERNAME` | ✅ | Login username |
+| `BIOSTAR_PASSWORD` | ✅ | Login password |
+| `VERIFY_SSL` | ❌ | SSL verification (default: `true`) |
+| `API_TIMEOUT` | ❌ | API timeout in seconds (default: `30`) |
+
+### Changing Credentials
+
+1. Edit `claude_desktop_config.json`
+2. Update the `env` values
+3. Restart Claude Desktop
+
+## Available Tools (129+)
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **auth** | 4 | Login, logout, session management |
+| **users** | 23 | User CRUD, groups, CSV import/export |
+| **doors** | 22 | Door control, groups, APB settings |
+| **access** | 13 | Access groups and levels |
+| **devices** | 38 | Device management, network config |
+| **cards** | 5 | Card creation (CSN, Wiegand, QR) |
+| **events** | 6 | Event search, logs, export |
+| **audit** | 6 | Audit trail tracking |
+| **occupancy** | 2 | Occupancy analysis |
+| **logs** | 5 | Server log analysis |
+| **files** | 1 | File reading (CSV, PDF) |
+| **navigation** | 1 | UI navigation |
+| **help** | 3 | Documentation search |
+
+## Example Usage
+
+Once connected to Claude:
+
+```
+"List all users"
+"Create a user named John Smith"
+"Open the main entrance door"
+"Show access events from today"
+"How do I configure anti-passback?"
+```
+
+## Alternative Installation
+
+### Using pip
+
+```bash
+pip install suprema-biostar-mcp
+suprema-biostar-mcp
+```
+
+### From source
+
+```bash
+git clone https://github.com/supremainc/suprema-biostar-mcp.git
+cd suprema-biostar-mcp
+pip install -e .
+python -m biostar_x_mcp_server
+```
+
+## Requirements
+
+- Python 3.10+
+- BioStar X server with API access
+- Network connectivity to BioStar server
+- [uv](https://docs.astral.sh/uv/) for `uvx` command (recommended)
+
+## Documentation
+
+- **BioStar X Docs**: https://docs.supremainc.com/en/platform/biostar_x
+- **MCP Protocol**: https://modelcontextprotocol.io
+
+## Support
+
+- **Suprema Support**: https://www.supremainc.com/support
+- **Documentation**: https://docs.supremainc.com
+
+---
+
+Made with ❤️ by [Suprema Inc.](https://www.supremainc.com)

suprema_biostar_mcp-1.0.1.dist-info/RECORD

@@ -0,0 +1,61 @@
+biostar_x_mcp_server/__init__.py,sha256=c0-TimXKCB0Y8DZNxqB1p6K5ls4Lur57nULBmjfoVaI,564
+biostar_x_mcp_server/__main__.py,sha256=PE7VsJJ8S7_WdFlp2cmXK7DCxR8biXCyHTgwS6HcW-0,333
+biostar_x_mcp_server/config.py,sha256=e0JSYTOxSFW3IsE3ychc20tBJqPv0K513y-J3uFd3Rs,2830
+biostar_x_mcp_server/server.py,sha256=pLaqOnwYsVBs3yLNvkiGu1f2DVH5fo-ZKJUj_XHYBC0,12150
+biostar_x_mcp_server/session.py,sha256=glMu4B5GxhzQ9Qrx1ixrNzykbYOBOHEGlpFz5plm4Dk,8132
+biostar_x_mcp_server/tool_manager.py,sha256=KQoud2RreGY3vvFvcZAu0yhwqqAmYzX180jL_Nw6EAo,6268
+biostar_x_mcp_server/handlers/__init__.py,sha256=fZzjY6lLyfMeaT2DPemFzZzpTbpD_8cjIvUIA_kEHOU,988
+biostar_x_mcp_server/handlers/access_handler.py,sha256=pnqSb1KE_z5HIE9nSH05XCkWqAAdNlkXc3LR93DTy0Q,102782
+biostar_x_mcp_server/handlers/audit_handler.py,sha256=TqDhqJ71pJQrhXJQOG9bqAdzSo3pQtcdTbhfeYDQKcY,20190
+biostar_x_mcp_server/handlers/auth_handler.py,sha256=OpgAc8WEz-H7I1nrLJiq7P2JKox9ZnR9b9Sfx7QQP9g,9657
+biostar_x_mcp_server/handlers/base_handler.py,sha256=kq-xiR51nqCZqqrlHVVMFpk1d5Jt2nnKfcSRdh5EDGI,8906
+biostar_x_mcp_server/handlers/card_handler.py,sha256=-FirNW38f5NMipEQGKH2r9JjIUM95JrUS3urjj9SIYE,30958
+biostar_x_mcp_server/handlers/device_handler.py,sha256=w7xqxUcJlCJdyiD5_s7pn9xVGeBJwtGT03oyodMIt0A,194686
+biostar_x_mcp_server/handlers/door_handler.py,sha256=K30varhRDcK0c_FjYDrtGinLZdoI0Q8kl0-3HyRRggk,181109
+biostar_x_mcp_server/handlers/event_handler.py,sha256=DYLqgxxBXOzaCaCNKkydjb8ewoFyy_OZX5eYM72Xc0A,60972
+biostar_x_mcp_server/handlers/file_handler.py,sha256=SsrH8MsWZAyXGiWcj8_T14jnNVxKBKXnyXNarTlrJJo,8930
+biostar_x_mcp_server/handlers/help_web_handler.py,sha256=bsUtAJO6-gVFVGfLly2mwKCQpH8EqqqMGSf12K4jAXE,15704
+biostar_x_mcp_server/handlers/log_handler.py,sha256=HLn54xVu6WAkZ2BPGj7Uq3w_0sys0bEUDmOiuGksIpM,49184
+biostar_x_mcp_server/handlers/navigation_handler.py,sha256=gA9sKVsEOcLCBY8NG97XYgWRdphJp0InCut-8KE9szs,4047
+biostar_x_mcp_server/handlers/occupancy_handler.py,sha256=z-vP70KRkDbVZ1lNskcWfCb6r2Uy-htIYTKVIbW4pu8,26843
+biostar_x_mcp_server/handlers/user_handler.py,sha256=ZHN9Sf0qwgTF7D8RcKGGQAmtNIyYqRv52BPRESMSaXM,169961
+biostar_x_mcp_server/schemas/__init__.py,sha256=rUkCWWp-Hf7lZMx4Z8T-K_ydPGuKIrnVWEqDwbO6U9g,451
+biostar_x_mcp_server/schemas/access.py,sha256=KM91sITs0YGeCkywkG9ayUK-dBbWmzixVKwKQXvLRzI,9485
+biostar_x_mcp_server/schemas/audit.py,sha256=P_Cqc87uVduQoGcdOBAZSihIbVOq_s5HT4o5TGFeBP8,4163
+biostar_x_mcp_server/schemas/auth.py,sha256=Dm9xcCvkJve1TvKtAz1w3gclc4r84ORbgkZOKLily_Y,768
+biostar_x_mcp_server/schemas/cards.py,sha256=aAq0wI89RSSWaY9e1AT7r9K5s0d7ldUNlQYbJ-v4g8I,5963
+biostar_x_mcp_server/schemas/devices.py,sha256=GQKlM28W19OOH58hOYK_HOpabZlyz6BF-eFLevbQNj8,32585
+biostar_x_mcp_server/schemas/doors.py,sha256=wPBaCPvBDf5PFHaRDqLxudYgO5JNtQhwQ0BE6KQLnpY,19746
+biostar_x_mcp_server/schemas/events.py,sha256=jrxLzj_Txx23e6ntwoZsB89NMKtYy0oe8RrkeTx5XNk,8100
+biostar_x_mcp_server/schemas/files.py,sha256=qkOcgNH4fh2pcFkTKT9R2PZp26oqY3tTQqnkyunXj2w,239
+biostar_x_mcp_server/schemas/help.py,sha256=BwIjY75XjuaEFZYTg807a5i_8EYfva9EFqCXoYDB0Ls,1632
+biostar_x_mcp_server/schemas/logs.py,sha256=w_qpuzDYmazba-niUT04ltCDogJwIi9uulqKk31W4mE,1973
+biostar_x_mcp_server/schemas/occupancy.py,sha256=K3rDin05SiGuVFrPZd8Cx6PWgcxJFBFdIoHtzvhfiMA,1095
+biostar_x_mcp_server/schemas/tool_response.py,sha256=THGJuTC9zgDisVUYyhF1xB_jffoUqOVlnD-rJCBGCWE,1190
+biostar_x_mcp_server/schemas/users.py,sha256=73QLF60BkgKNjt4jxGDtY1EJFr0PIBJBw0D5T2fnlQ8,11989
+biostar_x_mcp_server/tools/__init__.py,sha256=HcQKVOTtyoNJTvAdqktSgOCTuHkViuOxQsy7S0NkaGM,1053
+biostar_x_mcp_server/tools/access.py,sha256=kiipY9doDB7WDOtVfwmLcT7R1nUbMi0JIRVwpI_wx5M,20389
+biostar_x_mcp_server/tools/audit.py,sha256=uyv7iE2rftLEQdC1Wsx7T6-Vn0JdrfbI3jKowYPLX1Q,7668
+biostar_x_mcp_server/tools/auth.py,sha256=biFMcnjKzZIP-zWOvrf8pVnem-yY2b5TYZZa3wOckj0,2634
+biostar_x_mcp_server/tools/cards.py,sha256=wXrnJMXAezyhuMHKPe_mTsoiEUDzqBrWXS0tDislAK8,11689
+biostar_x_mcp_server/tools/categories.py,sha256=tUM7By7qux3us1cMTwc6BTbY3W9K3jIVqL_VT4-oYKY,6085
+biostar_x_mcp_server/tools/devices.py,sha256=Lq-KkzKlYoq2sE41kP5L61Hm_HR47JBuwaRBs6__ekk,63972
+biostar_x_mcp_server/tools/doors.py,sha256=szT_OIWHKBUyXbd55M9jKSdbipB_Of-b3aeB5ONX9dY,36999
+biostar_x_mcp_server/tools/events.py,sha256=ndY2bK23DaGhLT25pt6KfRKVjK-bHAOC-SGdVkJW20g,13012
+biostar_x_mcp_server/tools/files.py,sha256=zCCQ1bupYalWcXvR8bzSEGe7eKwiBXlj_O6Q0JfDYgY,1064
+biostar_x_mcp_server/tools/help.py,sha256=M1pfZu_fdLlcLqs-kKXtbmt10bgow6Fx-efuBpkaBHE,2853
+biostar_x_mcp_server/tools/logs.py,sha256=5YF1bkpCcyJJm-LdpElFI_j3TrsxxIuySrZU0Io8Biw,5325
+biostar_x_mcp_server/tools/navigation.py,sha256=bRQREsi9Vm18d7svZKVjUkyeADKRCswvuQIYsUm2gMc,3794
+biostar_x_mcp_server/tools/occupancy.py,sha256=wi5rZ6LZmTH_j13dmmqpc_kA2G2THAz-tdppG4WZIsc,2793
+biostar_x_mcp_server/tools/users.py,sha256=LiMvqBLqcAvYgk4aosh0-3nE2U1yldkVtebYrbvWbTY,46733
+biostar_x_mcp_server/utils/__init__.py,sha256=1XCi0dnqrF80q72oC75tqi65MEZV5ldRTUgIezYYcKM,655
+biostar_x_mcp_server/utils/category_mapper.py,sha256=FQtwojzdFtiYmykvmosIdbIr8dg7me_iHUzQxGvZkJE,7731
+biostar_x_mcp_server/utils/decorators.py,sha256=p8Zh6HwuP80sA0o_2B1rYG3H9o_5kki2SgLwqyWnizw,3092
+biostar_x_mcp_server/utils/language_detector.py,sha256=gO4jSbHFl3QpWwXOJxcLCnHzxq_MGyGoccWNtbHsFcc,1465
+biostar_x_mcp_server/utils/search.py,sha256=Wum130sIeEpMLhHJsUINd56vUYUDtSCQ8SJX02GSKl0,1332
+biostar_x_mcp_server/utils/timezone.py,sha256=vB3EcAd1ExopRiMOmyp2FqxAF8UcfmhxNfJ_Nc1NyWM,4743
+suprema_biostar_mcp-1.0.1.dist-info/METADATA,sha256=K0ry1q3ju8xLUQ_GxgKESogntSPECm_wK4DZinWykpU,4868
+suprema_biostar_mcp-1.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+suprema_biostar_mcp-1.0.1.dist-info/entry_points.txt,sha256=DX5MSXxdgiFbE6Aezg3DcMXojUv3QWkq1U_9FZzKHG4,73
+suprema_biostar_mcp-1.0.1.dist-info/licenses/LICENSE,sha256=QqZFelJ6EKRm0vB1AIZ5yKKA4HryNm0FfUlvq5o4LzY,1090
+suprema_biostar_mcp-1.0.1.dist-info/RECORD,,

suprema_biostar_mcp-1.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

suprema_biostar_mcp-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+suprema-biostar-mcp = biostar_x_mcp_server.server:main

suprema_biostar_mcp-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Suprema Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.