bdshare 1.2.2__tar.gz → 1.2.3__tar.gz

{bdshare-1.2.2 → bdshare-1.2.3}/CHANGELOG.md

@@ -6,6 +6,23 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
+## [1.2.3] - 2026-07-22
+
+### Added
+- `bdshare/indicators.py` — technical indicator helpers (`add_sma`, `add_ema`, `add_rsi`, `add_macd`, `add_bollinger_bands`, `add_indicators`) built on the `ta` library, operating on the OHLCV DataFrames returned by `get_basic_historical_data()`; install with `pip install bdshare[ta]`
+- `bdshare/portfolio.py` — `Portfolio`/`Position` classes for tracking cost basis and valuing holdings against live prices (`holdings()`, `valuation()`, `summary()`); one live call for all instruments regardless of portfolio size
+- `bdshare/stream.py` — polling-based WebSocket tick streaming (`stream_ticks()`, `TickServer`); broadcasts changed rows from `get_current_trade_data()` to connected clients so another program can subscribe over `ws://` instead of polling itself. DSE has no push API, so this is poll-and-diff under a WebSocket-shaped interface, not true push. Install with `pip install bdshare[stream]`, run with `bdshare-stream`
+- `demo/streamlit/streamlit_app.py` — full-feature Streamlit dashboard showcasing every public feature in one app: live trading data, historical charts with `bdshare.indicators` overlays, market movers, news, `bdshare.portfolio` tracking, live-tick polling, and an interactive AI-agent (MCP) tool explorer. Runs via `docker compose up --build streamlit` (`demo/streamlit/Dockerfile`, builds bdshare from local source so unreleased features are included) or locally with `pip install -e ".[ta,stream]"` + `streamlit run demo/streamlit/streamlit_app.py`
+- `demo/` reorganized into `demo/flask/`, `demo/streamlit/`, and `demo/node/`, all built from `demo/docker-compose.yml` with a repo-root build context; documented in `demo/README.md` (previously an unrelated generic Flask/Plotly readme with no mention of bdshare or Docker)
+- `bdshare-mcp --transport streamable-http --host 0.0.0.0 --port 8000` — the MCP server can now run over the network instead of only stdio, for clients that can't spawn it as a local child process (a different language, another container). Binding beyond loopback auto-disables DNS-rebinding protection, since every legitimate client then arrives with a non-localhost `Host` header
+- `demo/node/` — a four-service showcase of consuming bdshare from **outside Python**: an Express UI (`demo/node/server`, never imports bdshare) talking to a FastAPI backend (`demo/node/api`, bdshare functions as JSON REST) over REST, to `bdshare-mcp --transport streamable-http` over MCP via the official `@modelcontextprotocol/sdk`, and to `bdshare-stream` over WebSocket (relayed to the browser). Run via `docker compose up --build node node-api mcp stream` or locally per `demo/README.md`
+
+### Fixed
+- `bdshare.BDShareError` (the publicly exported/documented exception) was a **different class** from `bdshare.util.helper.BDShareError`, the one every scraping function actually raises — `except bdshare.BDShareError` silently never caught real errors. `bdshare/__init__.py` now re-exports the same class instead of redefining it
+- `demo/app.py`: `convert_to_native_types()` called `pd.isna(obj)` before checking whether `obj` was a list/dict, crashing with `ValueError: The truth value of an array... is ambiguous` on any chart request; container types are now checked first
+- `demo/app.py`: `get_available_tickers()` checked for a `trading_code` column that doesn't exist on `get_current_trade_data()`'s output (`symbol` does), so it always silently fell back to the hardcoded stock list
+- `demo/Dockerfile`: base image `python:3.11-slim-buster` is EOL (Debian Buster archived), so `apt-get update` would fail on a fresh build; switched to `python:3.11-slim`
+
 ## [1.2.2] - 2026-07-22
 
 ### Added

{bdshare-1.2.2/bdshare.egg-info → bdshare-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bdshare
-Version: 1.2.2
+Version: 1.2.3
 Summary: A utility for crawling historical and Real-time Quotes of DSE(Dhaka Stock Exchange)
 Author: Raisul Islam
 Author-email: raisul.me@gmail.com
@@ -20,6 +20,10 @@ Provides-Extra: polars
 Requires-Dist: polars; extra == "polars"
 Provides-Extra: mcp
 Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: ta
+Requires-Dist: ta; extra == "ta"
+Provides-Extra: stream
+Requires-Dist: websockets>=12.0; extra == "stream"
 Dynamic: license-file
 
 # bdshare
@@ -38,6 +42,7 @@ Dynamic: license-file
 
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Demo App](#demo-app)
 - [Core Concepts](#core-concepts)
 - [Usage Guide](#usage-guide)
   - [Live Trading Data](#live-trading-data)
@@ -49,6 +54,10 @@ Dynamic: license-file
 - [Error Handling](#error-handling)
 - [API Reference](#api-reference)
 - [Examples](#examples)
+- [Advanced Features](#advanced-features)
+  - [Technical Indicators](#technical-indicators)
+  - [Portfolio Tracking](#portfolio-tracking)
+  - [Real-Time Streaming (WebSocket)](#real-time-streaming-websocket)
 - [Using bdshare with AI Agents (MCP Server)](#using-bdshare-with-ai-agents-mcp-server)
 - [Contributing](#contributing)
 - [Roadmap](#roadmap)
@@ -100,6 +109,29 @@ with BDShare() as bd:
 
 ---
 
+## Demo App
+
+Three full-feature demos live in [`demo/`](demo/) — live prices, historical charts with
+technical indicators, market movers, news, a portfolio tracker, live tick polling, and
+an interactive AI-agent (MCP) tool explorer:
+
+```bash
+cd demo
+docker compose up --build streamlit   # pure Python — open http://localhost:8501
+docker compose up --build node node-api mcp stream  # cross-language via REST/MCP/WebSocket — open http://localhost:3000
+docker compose up --build app         # Flask/Plotly candlestick-only demo — open http://localhost:9999
+```
+
+The Node.js demo is the interesting one if you're integrating bdshare from **outside
+Python**: it's an Express UI that never imports bdshare — it talks to a FastAPI backend
+over REST, to `bdshare-mcp` over HTTP using the official MCP SDK, and to
+`bdshare-stream` over WebSocket, showing three different ways another program can
+consume this library.
+
+See [`demo/README.md`](demo/README.md) for local (non-Docker) setup for each.
+
+---
+
 ## Core Concepts
 
 | Concept | Details |
@@ -448,6 +480,100 @@ print(big_movers[['symbol', 'close', 'change']])
 
 ---
 
+## Advanced Features
+
+### Technical Indicators
+
+Wraps the [`ta`](https://github.com/bukosabino/ta) library to add indicator columns
+directly onto bdshare's OHLCV DataFrames.
+
+```bash
+pip install "bdshare[ta]"
+```
+
+```python
+from bdshare import get_basic_historical_data
+from bdshare.indicators import add_indicators, add_rsi
+
+df = get_basic_historical_data('2024-01-01', '2024-06-30', 'GP')
+
+# Add everything (sma_20, ema_20, rsi_14, macd/macd_signal/macd_diff, bb_high/bb_mid/bb_low)
+df = add_indicators(df)
+
+# Or just one, with custom parameters
+df = add_rsi(df, window=21)
+```
+
+Also available: `add_sma()`, `add_ema()`, `add_macd()`, `add_bollinger_bands()`.
+Each returns a new DataFrame (the input is never mutated).
+
+### Portfolio Tracking
+
+`Portfolio` tracks cost basis and values holdings against live prices — no extra
+dependency required (pure pandas), and `valuation()` makes exactly **one** live call
+for all instruments regardless of how many positions you hold.
+
+```python
+from bdshare.portfolio import Portfolio
+
+pf = Portfolio()
+pf.add_position('GP', quantity=100, avg_cost=450.50)
+pf.add_position('ACI', quantity=50, avg_cost=225.75)
+
+print(pf.holdings().to_string())    # cost basis only, no network call
+print(pf.valuation().to_string())   # + ltp, market_value, pnl, pnl_pct per position
+print(pf.summary())                 # {'positions': 2, 'total_cost': ..., 'total_pnl': ...}
+```
+
+Adding to an existing position blends the cost basis like a real buy; a negative
+`quantity` reduces it, and netting to zero drops the position. Unknown/delisted
+symbols get `None` valuation fields instead of raising, so one bad symbol doesn't
+block valuing the rest.
+
+### Real-Time Streaming (WebSocket)
+
+DSE has no public push/streaming API — this polls `get_current_trade_data()` on an
+interval and broadcasts **changed** rows over WebSocket, so another program can
+subscribe instead of polling bdshare itself.
+
+```bash
+pip install "bdshare[stream]"
+```
+
+Run the bundled server:
+
+```bash
+bdshare-stream --symbols GP,ACI --interval 5
+```
+
+Any other program connects as a plain WebSocket client:
+
+```python
+import asyncio, json, websockets
+
+async def main():
+    async with websockets.connect('ws://localhost:8765') as ws:
+        async for message in ws:
+            print(json.loads(message))   # {"type": "ticks", "data": [...]}
+
+asyncio.run(main())
+```
+
+Or skip the server and use the polling generator directly inside your own asyncio
+program:
+
+```python
+from bdshare.stream import stream_ticks
+
+async def main():
+    async for changed in stream_ticks(symbols=['GP', 'ACI'], interval=5.0):
+        print(changed)
+
+asyncio.run(main())
+```
+
+---
+
 ## Using bdshare with AI Agents (MCP Server)
 
 bdshare ships an [MCP](https://modelcontextprotocol.io/) server so AI agents running in
@@ -493,6 +619,23 @@ claude mcp add bdshare -- bdshare-mcp
 Any other MCP client is configured the same way — point it at the `bdshare-mcp` command
 (or `python -m bdshare.mcp_server`), stdio transport.
 
+### Running it over the network instead of stdio
+
+Stdio only works when the client can spawn the server as a local child process (Claude
+Desktop/Code). For a program in **another container, another machine, or another
+language entirely** — nothing that speaks Python — run it over HTTP instead:
+
+```bash
+bdshare-mcp --transport streamable-http --host 0.0.0.0 --port 8000
+```
+
+Any MCP client library can connect to `http://host:8000/mcp`; see
+[`demo/node/`](demo/node/) for a full example using the official
+`@modelcontextprotocol/sdk` from Node.js. Binding beyond `127.0.0.1`/`localhost`
+automatically disables DNS-rebinding protection, since every legitimate client then
+arrives with a non-localhost `Host` header — only do this on a trusted network (an
+internal Docker network, not the public internet).
+
 ### What the agent gets
 
 15 tools covering the same data this README documents — `market_status`,
@@ -535,11 +678,10 @@ Please open an issue before submitting a pull request for significant changes. S
 
 ## Roadmap
 
-- [ ] Chittagong Stock Exchange (CSE) support
-- [ ] WebSocket streaming for real-time ticks
-- [ ] Built-in technical indicators (`ta` integration)
-- [ ] Portfolio management helpers
-- [ ] Docker demo examples
+- [x] WebSocket streaming for real-time ticks (polling-based — see [Real-Time Streaming](#real-time-streaming-websocket))
+- [x] Built-in technical indicators (`ta` integration)
+- [x] Portfolio management helpers
+- [x] Docker demo examples
 - [x] Shared session with exponential back-off
 - [x] `lxml`-based fast parsing
 - [x] `BDShareError` for clean error handling
@@ -572,6 +714,23 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
+## [1.2.3] - 2026-07-22
+
+### Added
+- `bdshare/indicators.py` — technical indicator helpers (`add_sma`, `add_ema`, `add_rsi`, `add_macd`, `add_bollinger_bands`, `add_indicators`) built on the `ta` library, operating on the OHLCV DataFrames returned by `get_basic_historical_data()`; install with `pip install bdshare[ta]`
+- `bdshare/portfolio.py` — `Portfolio`/`Position` classes for tracking cost basis and valuing holdings against live prices (`holdings()`, `valuation()`, `summary()`); one live call for all instruments regardless of portfolio size
+- `bdshare/stream.py` — polling-based WebSocket tick streaming (`stream_ticks()`, `TickServer`); broadcasts changed rows from `get_current_trade_data()` to connected clients so another program can subscribe over `ws://` instead of polling itself. DSE has no push API, so this is poll-and-diff under a WebSocket-shaped interface, not true push. Install with `pip install bdshare[stream]`, run with `bdshare-stream`
+- `demo/streamlit/streamlit_app.py` — full-feature Streamlit dashboard showcasing every public feature in one app: live trading data, historical charts with `bdshare.indicators` overlays, market movers, news, `bdshare.portfolio` tracking, live-tick polling, and an interactive AI-agent (MCP) tool explorer. Runs via `docker compose up --build streamlit` (`demo/streamlit/Dockerfile`, builds bdshare from local source so unreleased features are included) or locally with `pip install -e ".[ta,stream]"` + `streamlit run demo/streamlit/streamlit_app.py`
+- `demo/` reorganized into `demo/flask/`, `demo/streamlit/`, and `demo/node/`, all built from `demo/docker-compose.yml` with a repo-root build context; documented in `demo/README.md` (previously an unrelated generic Flask/Plotly readme with no mention of bdshare or Docker)
+- `bdshare-mcp --transport streamable-http --host 0.0.0.0 --port 8000` — the MCP server can now run over the network instead of only stdio, for clients that can't spawn it as a local child process (a different language, another container). Binding beyond loopback auto-disables DNS-rebinding protection, since every legitimate client then arrives with a non-localhost `Host` header
+- `demo/node/` — a four-service showcase of consuming bdshare from **outside Python**: an Express UI (`demo/node/server`, never imports bdshare) talking to a FastAPI backend (`demo/node/api`, bdshare functions as JSON REST) over REST, to `bdshare-mcp --transport streamable-http` over MCP via the official `@modelcontextprotocol/sdk`, and to `bdshare-stream` over WebSocket (relayed to the browser). Run via `docker compose up --build node node-api mcp stream` or locally per `demo/README.md`
+
+### Fixed
+- `bdshare.BDShareError` (the publicly exported/documented exception) was a **different class** from `bdshare.util.helper.BDShareError`, the one every scraping function actually raises — `except bdshare.BDShareError` silently never caught real errors. `bdshare/__init__.py` now re-exports the same class instead of redefining it
+- `demo/app.py`: `convert_to_native_types()` called `pd.isna(obj)` before checking whether `obj` was a list/dict, crashing with `ValueError: The truth value of an array... is ambiguous` on any chart request; container types are now checked first
+- `demo/app.py`: `get_available_tickers()` checked for a `trading_code` column that doesn't exist on `get_current_trade_data()`'s output (`symbol` does), so it always silently fell back to the hardcoded stock list
+- `demo/Dockerfile`: base image `python:3.11-slim-buster` is EOL (Debian Buster archived), so `apt-get update` would fail on a fresh build; switched to `python:3.11-slim`
+
 ## [1.2.2] - 2026-07-22
 
 ### Added

{bdshare-1.2.2 → bdshare-1.2.3}/README.md

@@ -14,6 +14,7 @@
 
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Demo App](#demo-app)
 - [Core Concepts](#core-concepts)
 - [Usage Guide](#usage-guide)
   - [Live Trading Data](#live-trading-data)
@@ -25,6 +26,10 @@
 - [Error Handling](#error-handling)
 - [API Reference](#api-reference)
 - [Examples](#examples)
+- [Advanced Features](#advanced-features)
+  - [Technical Indicators](#technical-indicators)
+  - [Portfolio Tracking](#portfolio-tracking)
+  - [Real-Time Streaming (WebSocket)](#real-time-streaming-websocket)
 - [Using bdshare with AI Agents (MCP Server)](#using-bdshare-with-ai-agents-mcp-server)
 - [Contributing](#contributing)
 - [Roadmap](#roadmap)
@@ -76,6 +81,29 @@ with BDShare() as bd:
 
 ---
 
+## Demo App
+
+Three full-feature demos live in [`demo/`](demo/) — live prices, historical charts with
+technical indicators, market movers, news, a portfolio tracker, live tick polling, and
+an interactive AI-agent (MCP) tool explorer:
+
+```bash
+cd demo
+docker compose up --build streamlit   # pure Python — open http://localhost:8501
+docker compose up --build node node-api mcp stream  # cross-language via REST/MCP/WebSocket — open http://localhost:3000
+docker compose up --build app         # Flask/Plotly candlestick-only demo — open http://localhost:9999
+```
+
+The Node.js demo is the interesting one if you're integrating bdshare from **outside
+Python**: it's an Express UI that never imports bdshare — it talks to a FastAPI backend
+over REST, to `bdshare-mcp` over HTTP using the official MCP SDK, and to
+`bdshare-stream` over WebSocket, showing three different ways another program can
+consume this library.
+
+See [`demo/README.md`](demo/README.md) for local (non-Docker) setup for each.
+
+---
+
 ## Core Concepts
 
 | Concept | Details |
@@ -424,6 +452,100 @@ print(big_movers[['symbol', 'close', 'change']])
 
 ---
 
+## Advanced Features
+
+### Technical Indicators
+
+Wraps the [`ta`](https://github.com/bukosabino/ta) library to add indicator columns
+directly onto bdshare's OHLCV DataFrames.
+
+```bash
+pip install "bdshare[ta]"
+```
+
+```python
+from bdshare import get_basic_historical_data
+from bdshare.indicators import add_indicators, add_rsi
+
+df = get_basic_historical_data('2024-01-01', '2024-06-30', 'GP')
+
+# Add everything (sma_20, ema_20, rsi_14, macd/macd_signal/macd_diff, bb_high/bb_mid/bb_low)
+df = add_indicators(df)
+
+# Or just one, with custom parameters
+df = add_rsi(df, window=21)
+```
+
+Also available: `add_sma()`, `add_ema()`, `add_macd()`, `add_bollinger_bands()`.
+Each returns a new DataFrame (the input is never mutated).
+
+### Portfolio Tracking
+
+`Portfolio` tracks cost basis and values holdings against live prices — no extra
+dependency required (pure pandas), and `valuation()` makes exactly **one** live call
+for all instruments regardless of how many positions you hold.
+
+```python
+from bdshare.portfolio import Portfolio
+
+pf = Portfolio()
+pf.add_position('GP', quantity=100, avg_cost=450.50)
+pf.add_position('ACI', quantity=50, avg_cost=225.75)
+
+print(pf.holdings().to_string())    # cost basis only, no network call
+print(pf.valuation().to_string())   # + ltp, market_value, pnl, pnl_pct per position
+print(pf.summary())                 # {'positions': 2, 'total_cost': ..., 'total_pnl': ...}
+```
+
+Adding to an existing position blends the cost basis like a real buy; a negative
+`quantity` reduces it, and netting to zero drops the position. Unknown/delisted
+symbols get `None` valuation fields instead of raising, so one bad symbol doesn't
+block valuing the rest.
+
+### Real-Time Streaming (WebSocket)
+
+DSE has no public push/streaming API — this polls `get_current_trade_data()` on an
+interval and broadcasts **changed** rows over WebSocket, so another program can
+subscribe instead of polling bdshare itself.
+
+```bash
+pip install "bdshare[stream]"
+```
+
+Run the bundled server:
+
+```bash
+bdshare-stream --symbols GP,ACI --interval 5
+```
+
+Any other program connects as a plain WebSocket client:
+
+```python
+import asyncio, json, websockets
+
+async def main():
+    async with websockets.connect('ws://localhost:8765') as ws:
+        async for message in ws:
+            print(json.loads(message))   # {"type": "ticks", "data": [...]}
+
+asyncio.run(main())
+```
+
+Or skip the server and use the polling generator directly inside your own asyncio
+program:
+
+```python
+from bdshare.stream import stream_ticks
+
+async def main():
+    async for changed in stream_ticks(symbols=['GP', 'ACI'], interval=5.0):
+        print(changed)
+
+asyncio.run(main())
+```
+
+---
+
 ## Using bdshare with AI Agents (MCP Server)
 
 bdshare ships an [MCP](https://modelcontextprotocol.io/) server so AI agents running in
@@ -469,6 +591,23 @@ claude mcp add bdshare -- bdshare-mcp
 Any other MCP client is configured the same way — point it at the `bdshare-mcp` command
 (or `python -m bdshare.mcp_server`), stdio transport.
 
+### Running it over the network instead of stdio
+
+Stdio only works when the client can spawn the server as a local child process (Claude
+Desktop/Code). For a program in **another container, another machine, or another
+language entirely** — nothing that speaks Python — run it over HTTP instead:
+
+```bash
+bdshare-mcp --transport streamable-http --host 0.0.0.0 --port 8000
+```
+
+Any MCP client library can connect to `http://host:8000/mcp`; see
+[`demo/node/`](demo/node/) for a full example using the official
+`@modelcontextprotocol/sdk` from Node.js. Binding beyond `127.0.0.1`/`localhost`
+automatically disables DNS-rebinding protection, since every legitimate client then
+arrives with a non-localhost `Host` header — only do this on a trusted network (an
+internal Docker network, not the public internet).
+
 ### What the agent gets
 
 15 tools covering the same data this README documents — `market_status`,
@@ -511,11 +650,10 @@ Please open an issue before submitting a pull request for significant changes. S
 
 ## Roadmap
 
-- [ ] Chittagong Stock Exchange (CSE) support
-- [ ] WebSocket streaming for real-time ticks
-- [ ] Built-in technical indicators (`ta` integration)
-- [ ] Portfolio management helpers
-- [ ] Docker demo examples
+- [x] WebSocket streaming for real-time ticks (polling-based — see [Real-Time Streaming](#real-time-streaming-websocket))
+- [x] Built-in technical indicators (`ta` integration)
+- [x] Portfolio management helpers
+- [x] Docker demo examples
 - [x] Shared session with exponential back-off
 - [x] `lxml`-based fast parsing
 - [x] `BDShareError` for clean error handling

{bdshare-1.2.2 → bdshare-1.2.3}/bdshare/__init__.py

@@ -52,7 +52,7 @@ from bdshare.util import (
     configure_proxy,
 )
 from bdshare.util.cache import _TTLCache
-from bdshare.util.helper import deprecated
+from bdshare.util.helper import deprecated, BDShareError
 
 # ---------------------------------------------------------------------------
 # Type aliases
@@ -87,10 +87,6 @@ def _validate_date_range(start_date: str, end_date: str) -> None:
         raise ValueError("Date range cannot exceed 5 years.")
 
 
-class BDShareError(Exception):
-    """Top-level client exception."""
-
-
 # ---------------------------------------------------------------------------
 # Rate limiter
 # ---------------------------------------------------------------------------

{bdshare-1.2.2 → bdshare-1.2.3}/bdshare/_version.py

@@ -1,2 +1,2 @@
-version_info = (1, 2, 2)
+version_info = (1, 2, 3)
 __version__ = ".".join(map(str, version_info))

bdshare-1.2.3/bdshare/indicators.py

@@ -0,0 +1,100 @@
+"""
+bdshare.indicators
+~~~~~~~~~~~~~~~~~~~
+Optional technical-indicator helpers built on the `ta` library, for use with
+the OHLCV DataFrames returned by get_basic_historical_data() and friends.
+
+Requires the optional 'ta' extra:
+    pip install bdshare[ta]
+"""
+from typing import Iterable, Optional
+
+import pandas as pd
+
+try:
+    from ta.momentum import RSIIndicator
+    from ta.trend import EMAIndicator, MACD, SMAIndicator
+    from ta.volatility import BollingerBands
+except ImportError as exc:
+    raise ImportError(
+        "Technical indicators require the 'ta' package. "
+        "Install it with: pip install bdshare[ta]"
+    ) from exc
+
+
+def add_sma(df: pd.DataFrame, window: int = 20, column: str = "close") -> pd.DataFrame:
+    """Add a Simple Moving Average column named ``sma_{window}``."""
+    out = df.copy()
+    out[f"sma_{window}"] = SMAIndicator(out[column], window=window).sma_indicator()
+    return out
+
+
+def add_ema(df: pd.DataFrame, window: int = 20, column: str = "close") -> pd.DataFrame:
+    """Add an Exponential Moving Average column named ``ema_{window}``."""
+    out = df.copy()
+    out[f"ema_{window}"] = EMAIndicator(out[column], window=window).ema_indicator()
+    return out
+
+
+def add_rsi(df: pd.DataFrame, window: int = 14, column: str = "close") -> pd.DataFrame:
+    """Add a Relative Strength Index column named ``rsi_{window}``."""
+    out = df.copy()
+    out[f"rsi_{window}"] = RSIIndicator(out[column], window=window).rsi()
+    return out
+
+
+def add_macd(
+    df: pd.DataFrame,
+    window_fast: int = 12,
+    window_slow: int = 26,
+    window_sign: int = 9,
+    column: str = "close",
+) -> pd.DataFrame:
+    """Add ``macd``, ``macd_signal``, and ``macd_diff`` (histogram) columns."""
+    out = df.copy()
+    macd = MACD(
+        out[column], window_fast=window_fast, window_slow=window_slow, window_sign=window_sign
+    )
+    out["macd"] = macd.macd()
+    out["macd_signal"] = macd.macd_signal()
+    out["macd_diff"] = macd.macd_diff()
+    return out
+
+
+def add_bollinger_bands(
+    df: pd.DataFrame, window: int = 20, window_dev: int = 2, column: str = "close"
+) -> pd.DataFrame:
+    """Add ``bb_high``, ``bb_mid``, and ``bb_low`` Bollinger Band columns."""
+    out = df.copy()
+    bb = BollingerBands(out[column], window=window, window_dev=window_dev)
+    out["bb_high"] = bb.bollinger_hband()
+    out["bb_mid"] = bb.bollinger_mavg()
+    out["bb_low"] = bb.bollinger_lband()
+    return out
+
+
+_INDICATORS = {
+    "sma": add_sma,
+    "ema": add_ema,
+    "rsi": add_rsi,
+    "macd": add_macd,
+    "bbands": add_bollinger_bands,
+}
+
+
+def add_indicators(df: pd.DataFrame, indicators: Optional[Iterable[str]] = None) -> pd.DataFrame:
+    """Add several indicators at once, each with its default parameters.
+
+    For custom parameters (e.g. a different SMA window), call the individual
+    ``add_*`` function directly instead.
+
+    :param indicators: Names from 'sma', 'ema', 'rsi', 'macd', 'bbands'.
+                        Defaults to all of them.
+    """
+    names = list(indicators) if indicators is not None else list(_INDICATORS)
+    out = df
+    for name in names:
+        if name not in _INDICATORS:
+            raise ValueError(f"Unknown indicator '{name}'. Choose from: {list(_INDICATORS)}")
+        out = _INDICATORS[name](out)
+    return out

{bdshare-1.2.2 → bdshare-1.2.3}/bdshare/mcp_server.py

@@ -11,6 +11,11 @@ Run directly:
 Or via the installed console script:
     bdshare-mcp
 
+Defaults to stdio transport (what Claude Desktop/Code expect). For a
+network-reachable server — e.g. so a non-Python program in another
+container can connect — pass --transport streamable-http --host 0.0.0.0:
+    bdshare-mcp --transport streamable-http --host 0.0.0.0 --port 8000
+
 Requires the optional 'mcp' extra:
     pip install bdshare[mcp]
 """
@@ -190,7 +195,27 @@ def agm_news() -> list:
 
 
 def main() -> None:
-    mcp.run()
+    import argparse
+
+    parser = argparse.ArgumentParser(description="bdshare MCP server.")
+    parser.add_argument(
+        "--transport", choices=["stdio", "sse", "streamable-http"], default="stdio",
+        help="MCP transport (default: stdio, for desktop/CLI agent clients like Claude Desktop/Code)",
+    )
+    parser.add_argument("--host", default="127.0.0.1", help="Host to bind for sse/streamable-http")
+    parser.add_argument("--port", type=int, default=8000, help="Port to bind for sse/streamable-http")
+    args = parser.parse_args()
+
+    if args.transport != "stdio":
+        mcp.settings.host = args.host
+        mcp.settings.port = args.port
+        if args.host not in ("127.0.0.1", "localhost"):
+            # Binding beyond loopback (e.g. inside a container network) means every
+            # legitimate client arrives with a non-localhost Host header — DNS-rebinding
+            # protection would otherwise reject all of them.
+            mcp.settings.transport_security.enable_dns_rebinding_protection = False
+
+    mcp.run(transport=args.transport)
 
 
 if __name__ == "__main__":