TypeScript SDK v0.3.0

What's Changed

Features

• Add clearCache() method to LSBibleClient for manual cache invalidation
• Add comprehensive caching documentation with examples

Documentation

• Enhanced cache provider documentation
• Added cache management examples

Full Changelog: typescript-sdk/v0.1.0...typescript-sdk/v0.3.0

Python SDK v0.3.0

What's Changed

Features

• Migrate to async cache architecture with pluggable cache providers
• Add support for custom cache implementations
• Improved cache performance and flexibility

Breaking Changes

• Cache architecture is now async-based. If you were using custom cache implementations, you'll need to update them to support async operations.
• MCP Server removed from Python SDK: The Model Context Protocol (MCP) server has been migrated to TypeScript and is now available in the TypeScript SDK package. If you were using the Python MCP server, please switch to the TypeScript version.

Full Changelog: python-sdk/v0.2.0...python-sdk/v0.3.0

TypeScript SDK v0.1.0 - MCP Server & Cache Providers

Features

Model Context Protocol Server

• Complete MCP server implementation with tools, resources, and prompts
• Cloudflare Workers deployment with edge caching
• Stdio transport for local/custom integrations

Pluggable Cache Architecture

• Interface-based cache system supporting multiple providers
• Memory cache for development and stdio servers
• Cloudflare Cache API provider for Workers
• No-op cache for testing

MCP Capabilities

• 4 Tools: get_verse, get_passage, get_chapter, search_bible
• 2 Resources: bible://books, bible://structure/{book}
• 2 Prompts: bible_study, cross_reference

Installation

```bash
npm install lsbible

or

bun add lsbible
```

Documentation

See the TypeScript SDK README for full documentation.

Python SDK v0.2.0 - MCP Server & Search Enhancements

LSBible Python SDK v0.2.0

New Features

MCP Server

• Full Model Context Protocol (MCP) server implementation using FastMCP
• 4 tools: get_verse, get_passage, get_chapter, search_bible
• 2 resources: bible://books, bible://structure/{book}
• 2 prompts: bible_study, cross_reference
• Type coercion for robust parameter handling (accepts both int and string)
• Command-line entry point: lsbible-mcp
• Easy integration with Claude Desktop and other MCP clients

Enhanced Search Functionality

• Text search now returns rich distribution metadata
• Distribution across 8 Bible sections (Pentateuch, History, Wisdom & Poetry, etc.)
• Distribution across individual books
• Helps understand topical coverage across Scripture
• Automatic detection of search vs reference queries
• Preserves all existing functionality

Analytics Support

• Automatic User-Agent header for usage tracking
• Format: lsbible-python/VERSION (Python/X.Y.Z; PLATFORM; +https://github.com/kdcokenny/lsbible)
• Helps LSBible track SDK usage
• Customizable for enterprise requirements

Bug Fixes

• Fixed parser handling of first verses (verses lacking <small> tags)
• Fixed Song of Solomon → Song of Songs naming consistency

Documentation

• Comprehensive MCP server setup guide
• Search distribution metadata examples
• Claude Desktop configuration instructions
• Development guidelines in CLAUDE.md

Testing

• 142 tests passing with 95% coverage
• New MCP server test suite (20 tests)
• User-Agent header verification tests

Installation

```bash

Basic SDK

pip install lsbible

With MCP server support

pip install lsbible[server]
```

MCP Server Quick Start

```bash

Run the server

lsbible-mcp

Or add to Claude Desktop config

{
"mcpServers": {
"lsbible": {
"command": "uvx",
"args": ["--from", "lsbible[server]", "lsbible-mcp"]
}
}
}
```

What's Changed

• feat: add MCP server with type coercion for robust parameter handling (007e03e)
• feat: enhance search to handle text queries with metadata (be6c8c6)
• feat: add User-Agent header for analytics tracking (50e695e)
• fix: parser handling of first verses and Song of Songs book name (d7ec2c8)
• docs: document search distribution metadata in README (fc9386e)

Full Changelog: https://github.com/kdcokenny/lsbible/commits/python-sdk/v0.2.0