smartbill-interface 0.1.1__tar.gz

smartbill_interface-0.1.1/.gitignore

@@ -0,0 +1,29 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Environment variables
+.env
+.env.*
+
+# OS
+.DS_Store
+Thumbs.db

smartbill_interface-0.1.1/BUILD.md

@@ -0,0 +1,27 @@
+# SmartBill Interface
+
+## Build and Publish
+
+```bash
+uv build
+
+#test publish
+uv publish --token xxxxTESTxxxxxxx  --publish-url https://test.pypi.org/legacy/
+uvx --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ smartbill-interface
+
+#publish
+uv publish --token xxxxxxxxxxxxxxx
+```
+
+## Run Locally
+
+```bash
+uvx --from . smartbill-interface
+
+#or
+
+uvx --from /mnt/c/projects/smartbill-mcp-server smartbill-interface
+
+#or run from wheel file
+uvx --from ./dist/smartbill_interface-0.1.1-py3-none-any.whl smartbill-interface
+```

smartbill_interface-0.1.1/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: smartbill-interface
+Version: 0.1.1
+Summary: MCP server for interfacing with smartbill.ro for conducting financial operations
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=2.14.5
+Requires-Dist: requests>=2.32.5
+Requires-Dist: starlette>=0.52.1
+Requires-Dist: uvicorn>=0.40.0
+Description-Content-Type: text/markdown
+
+# SmartBill Interface MCP Server
+
+MCP server for interfacing with smartbill.ro for conducting financial operations.
+
+## MCP Server - Stdio
+
+### Run
+
+```bash
+export SMARTBILL_USERNAME="myname@mycompany.ro"
+export SMARTBILL_TOKEN="xxxxxxxxxxxxxx"
+uvx smartbill-interface
+```
+
+### Use from Claude Code
+
+```json
+"mcpServers": {
+    "smartbill-interface": {
+        "type": "stdio",
+        "command": "uvx",
+        "args": [
+            "smartbill-interface"
+        ]
+        "env": {
+            "SMARTBILL_USERNAME": "${SMARTBILL_USERNAME}",
+            "SMARTBILL_TOKEN": "${SMARTBILL_TOKEN}"
+        }
+    }
+}
+```
+
+Before running `claude`, export the 2 environment variables with the real values for your smartbill account:
+
+```
+export SMARTBILL_USERNAME="myname@mycompany.ro"
+export SMARTBILL_TOKEN="xxxxxxxxxxxxxx"
+```
+
+#### Sample Prompt 1
+
+`Get the payment status for a bill with CIF RO39999999, series XX2025, number 0003`
+
+Response:
+
+```
+● smartbill-interface - _get_payment_status (MCP)(cif: "RO39999999", series: "XX2025", number: "0003")
+
+● Here's the payment status for the bill:
+
+  ┌───────────────┬────────┐
+  │     Field     │ Amount │
+  ├───────────────┼────────┤
+  │ Total Amount  │ 111.62 │
+  ├───────────────┼────────┤
+  │ Paid Amount   │ 0.00   │
+  ├───────────────┼────────┤
+  │ Unpaid Amount │ 111.62 │
+  └───────────────┴────────┘
+
+The bill (series XX2025, number 0003, CIF RO39999999) is fully unpaid — no payments have been recorded against the total of 111.62.
+```
+
+#### Sample Prompt 2
+
+`Get the bill with CIF RO39999999, series XX2025, number 0003`
+
+Response:
+
+```
+smartbill-interface - _get_bill (MCP)(cif: "RO39999999", series: "XX2025", number: "0003")
+
+● The bill was retrieved as a PDF blob. Let me extract and save it as a PDF file for you.
+
+● Read 1 file (ctrl+o to expand)
+
+● Bash(cat /home/mio/.claude/projects/myproject/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/tool-results/mcp-smartbill-interface-_get_bill-1111111111111.txt | python3 -c…)
+
+● The bill has been saved as bill_XX2025_0003.pdf (59 KB) in your working directory (/myproject/). You can open it directly from there.
+```
+
+### Test
+
+Test using MCP Inspector UI:
+
+```bash
+npx @modelcontextprotocol/inspector uvx smartbill-interface
+```
+
+Test from the command line:
+
+```bash
+npx @modelcontextprotocol/inspector --cli --method tools/list uvx smartbill-interface | jq -r .tools.[].name
+
+_get_payment_status
+_get_bill
+```

smartbill_interface-0.1.1/README.md

@@ -0,0 +1,97 @@
+# SmartBill Interface MCP Server
+
+MCP server for interfacing with smartbill.ro for conducting financial operations.
+
+## MCP Server - Stdio
+
+### Run
+
+```bash
+export SMARTBILL_USERNAME="myname@mycompany.ro"
+export SMARTBILL_TOKEN="xxxxxxxxxxxxxx"
+uvx smartbill-interface
+```
+
+### Use from Claude Code
+
+```json
+"mcpServers": {
+    "smartbill-interface": {
+        "type": "stdio",
+        "command": "uvx",
+        "args": [
+            "smartbill-interface"
+        ]
+        "env": {
+            "SMARTBILL_USERNAME": "${SMARTBILL_USERNAME}",
+            "SMARTBILL_TOKEN": "${SMARTBILL_TOKEN}"
+        }
+    }
+}
+```
+
+Before running `claude`, export the 2 environment variables with the real values for your smartbill account:
+
+```
+export SMARTBILL_USERNAME="myname@mycompany.ro"
+export SMARTBILL_TOKEN="xxxxxxxxxxxxxx"
+```
+
+#### Sample Prompt 1
+
+`Get the payment status for a bill with CIF RO39999999, series XX2025, number 0003`
+
+Response:
+
+```
+● smartbill-interface - _get_payment_status (MCP)(cif: "RO39999999", series: "XX2025", number: "0003")
+
+● Here's the payment status for the bill:
+
+  ┌───────────────┬────────┐
+  │     Field     │ Amount │
+  ├───────────────┼────────┤
+  │ Total Amount  │ 111.62 │
+  ├───────────────┼────────┤
+  │ Paid Amount   │ 0.00   │
+  ├───────────────┼────────┤
+  │ Unpaid Amount │ 111.62 │
+  └───────────────┴────────┘
+
+The bill (series XX2025, number 0003, CIF RO39999999) is fully unpaid — no payments have been recorded against the total of 111.62.
+```
+
+#### Sample Prompt 2
+
+`Get the bill with CIF RO39999999, series XX2025, number 0003`
+
+Response:
+
+```
+smartbill-interface - _get_bill (MCP)(cif: "RO39999999", series: "XX2025", number: "0003")
+
+● The bill was retrieved as a PDF blob. Let me extract and save it as a PDF file for you.
+
+● Read 1 file (ctrl+o to expand)
+
+● Bash(cat /home/mio/.claude/projects/myproject/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/tool-results/mcp-smartbill-interface-_get_bill-1111111111111.txt | python3 -c…)
+
+● The bill has been saved as bill_XX2025_0003.pdf (59 KB) in your working directory (/myproject/). You can open it directly from there.
+```
+
+### Test
+
+Test using MCP Inspector UI:
+
+```bash
+npx @modelcontextprotocol/inspector uvx smartbill-interface
+```
+
+Test from the command line:
+
+```bash
+npx @modelcontextprotocol/inspector --cli --method tools/list uvx smartbill-interface | jq -r .tools.[].name
+
+_get_payment_status
+_get_bill
+```

smartbill_interface-0.1.1/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "smartbill-interface"
+version = "0.1.1"
+description = "MCP server for interfacing with smartbill.ro for conducting financial operations"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+ "fastmcp>=2.14.5",
+ "starlette>=0.52.1",
+ "uvicorn>=0.40.0",
+ "requests>=2.32.5",
+]
+
+[project.scripts]
+smartbill-interface = "smartbillinterface.main:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/smartbillinterface"]

smartbill_interface-0.1.1/requirements.txt

@@ -0,0 +1,4 @@
+fastmcp==2.14.5
+starlette==0.52.1
+uvicorn==0.40.0
+requests==2.32.5

smartbill_interface-0.1.1/src/smartbillinterface/__init__.py

@@ -0,0 +1 @@
+"""SmartBill Interface MCP Server - Interfacing with smartbill.ro for conducting financial operations."""

smartbill_interface-0.1.1/src/smartbillinterface/main.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env python
+#MCP server for interfacing with smartbill.ro for conducting financial operations
+from urllib.request import urlopen, Request
+from urllib.error import HTTPError
+import mcp.server.fastmcp
+import mcp.types
+import logging
+import xml.etree.ElementTree as ET
+import os
+import base64
+
+logging.basicConfig(level=logging.DEBUG)
+logger = logging.getLogger(__name__)
+
+SMARTBILL_BASE_URL = "https://ws.smartbill.ro/SBORO/api"
+SMARTBILL_BILL_ID = "cif={cif}&seriesname={series}&number={number}"
+SMARTBILL_PAYMENT_STATUS_URL = SMARTBILL_BASE_URL + "/invoice/paymentstatus?" + SMARTBILL_BILL_ID
+SMARTBILL_GET_BILL_URL = SMARTBILL_BASE_URL + "/invoice/pdf?" + SMARTBILL_BILL_ID
+
+def _build_auth() -> str:
+    username = os.environ["SMARTBILL_USERNAME"]
+    token = os.environ["SMARTBILL_TOKEN"]
+    return base64.b64encode(f"{username}:{token}".encode()).decode()
+
+mymcp = mcp.server.fastmcp.FastMCP("SmartBill Interface Server")
+
+@mymcp.tool()
+def _get_payment_status(cif: str, series: str, number: str) -> tuple[float, float, float]:
+    """Get the payment status for a bill.
+
+    Returns total amount, paid amount and unpaid amount.
+    """
+    logger.debug(f"_get_payment_status for bill with cif: {cif}, series: {series} and number: {number}")
+    url = SMARTBILL_PAYMENT_STATUS_URL.format(cif=cif, series=series, number=number)
+    req = Request(url, headers={
+        "Content-Type": "application/xml",
+        "Accept": "application/xml",
+        "Authorization": f"Basic {_build_auth()}",
+    })
+    try:
+        with urlopen(req) as response:
+            xml_data = response.read()
+            logger.debug(f"Received answer: {xml_data}")
+            root = ET.fromstring(xml_data)
+            total_amount = float(root.findtext("invoiceTotalAmount"))
+            logger.debug(f"Answer contains total amount: {total_amount}")
+            paid_amount = float(root.findtext("paidAmount"))
+            logger.debug(f"Answer contains paid amount: {paid_amount}")
+            unpaid_amount = float(root.findtext("unpaidAmount"))
+            logger.debug(f"Answer contains unpaid amount: {unpaid_amount}")
+            return total_amount, paid_amount, unpaid_amount
+    except HTTPError as e:
+        logger.error(f"HTTP error {e.code} for URL {url}: {e.reason}")
+        raise
+
+@mymcp.tool()
+def _get_bill(cif: str, series: str, number: str) -> mcp.types.BlobResourceContents:
+    """Get a bill.
+
+    Returns the bill in PDF format as a blob.
+    """
+    logger.debug(f"_get_bill for bill with cif: {cif}, series: {series} and number: {number}")
+    url = SMARTBILL_GET_BILL_URL.format(cif=cif, series=series, number=number)
+    req = Request(url, headers={
+        "Content-Type": "application/xml",
+        "Accept": "application/xml",
+        "Accept": "application/octet-stream",
+        "Authorization": f"Basic {_build_auth()}",
+        "Content-Disposition": "attachment; filename=\"bill.pdf\"",
+    })
+    try:
+        with urlopen(req) as response:
+            bill = response.read()
+            logger.debug(f"Received {len(bill)} bytes")
+            return mcp.types.BlobResourceContents(
+                uri=url,
+                blob=base64.b64encode(bill).decode(),
+                mimeType="application/pdf",
+            )
+    except HTTPError as e:
+        logger.error(f"HTTP error {e.code} for URL {url}: {e.reason}")
+        raise
+
+def main():
+    """Entry point for the SmartBill MCP server."""
+    missing = [v for v in ("SMARTBILL_USERNAME", "SMARTBILL_TOKEN") if not os.environ.get(v)]
+    if missing:
+        logger.error(f"Missing required environment variables: {', '.join(missing)}")
+        return
+    mymcp.run(transport="stdio")
+
+if __name__ == "__main__":
+    main()