open-index/open-npm huggingface dataset:
npm package: @surgbc/egw-writings-api-server
Description: MCP server providing live access to EGW Writings API
Author: Brian Onango
Latest version: 1.0.0

# @surgbc/egw-writings-api-server

MCP server providing live access to Ellen G. White (EGW) Writings API for educational and research purposes.

## Overview

This Model Context Protocol (MCP) server provides real-time access to the EGW Writings database through the official API. It supports searching writings, browsing books by language, and retrieving detailed content with proper citation formatting.

## Features

- **Live API Access**: Real-time data from the official EGW Writings API
- **Full-text Search**: Search across all available writings
- **Multi-language Support**: Access content in 150+ languages
- **Book Management**: Browse and retrieve book metadata and content
- **Citation Support**: Proper reference formatting for academic use
- **OAuth Authentication**: Secure API access with automatic token management

## Installation

```bash
npm install -g @surgbc/egw-writings-api-server
```

## Usage

### As MCP Server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "egw-api": {
      "command": "egw-api-server",
      "env": {
        "EGW_CLIENT_ID": "your_client_id",
        "EGW_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}
```

### Environment Variables

Create a `.env` file or set environment variables:

```bash
EGW_CLIENT_ID=your_client_id
EGW_CLIENT_SECRET=your_client_secret
```

### Available Tools

- `search_writings` - Search EGW writings with full-text search
- `get_book_details` - Get detailed information about a specific book
- `get_book_content` - Retrieve chapters and content from a book
- `list_languages` - Get all available languages
- `list_books` - List books by language and filters
- `get_suggestions` - Get search suggestions and autocomplete

## Educational and Research Use

This tool is designed for educational and research purposes. The EGW writings may be subject to copyright restrictions. Users are responsible for ensuring their use complies with applicable copyright laws and fair use guidelines.

## Organization

Developed by [Gospel Sounders](https://github.com/gospelsounders) under the leadership of [Brian Onang'o](https://github.com/surgbc).

## License

UNLICENSED - Proprietary software for educational and research use.

## Support

- [Issues](https://github.com/gospelsounders/egw-writings-mcp/issues)
- [Documentation](https://github.com/gospelsounders/egw-writings-mcp#readme)
npm package: @surgbc/egw-writings-downloader
Description: Data extraction and database population tool for EGW Writings
Author: Brian Onango
Latest version: 1.0.0

# @surgbc/egw-writings-downloader

Data extraction and database population tool for Ellen G. White (EGW) Writings for educational and research purposes.

## Overview

This command-line tool downloads and indexes EGW writings content into a local SQLite database with full-text search capabilities. It's designed to create a high-performance local database for research and educational use.

## Features

- **Bulk Download**: Download languages, books, and content efficiently
- **SQLite Database**: High-performance local storage with FTS5 search
- **Progress Tracking**: Monitor download progress and resume interrupted downloads
- **Rate Limiting**: Respectful API usage with built-in delays
- **Selective Downloads**: Choose specific languages, books, or content ranges
- **Quick Start**: Automated setup for immediate use

## Installation

```bash
npm install -g @surgbc/egw-writings-downloader
```

## Usage

### Quick Start

Set up a sample database with English content:

```bash
egw-downloader quick-start
```

### Individual Commands

```bash
# Download all available languages
egw-downloader languages

# Download books for a specific language
egw-downloader books --lang en --limit 50

# Download content for books
egw-downloader content --lang en --limit 10

# Download specific book content
egw-downloader content --book 123

# Show database statistics
egw-downloader stats
```

### Environment Variables

Create a `.env` file or set environment variables:

```bash
EGW_CLIENT_ID=your_client_id
EGW_CLIENT_SECRET=your_client_secret
```

## Database Structure

The tool creates a SQLite database with:

- **Languages**: Available language codes and metadata
- **Books**: Complete book metadata including authors, publication info
- **Paragraphs**: Full content with reference codes and search indexing
- **FTS5 Search**: Full-text search capabilities for fast content discovery

## Performance

- **Local Database**: No API calls needed after initial download
- **FTS5 Search**: Millisecond search response times
- **Efficient Storage**: Optimized schema with proper indexing
- **Incremental Updates**: Download only new or changed content

## Educational and Research Use

This tool is designed for educational and research purposes. The EGW writings may be subject to copyright restrictions. Users are responsible for ensuring their use complies with applicable copyright laws and fair use guidelines.

## Organization

Developed by [Gospel Sounders](https://github.com/gospelsounders) under the leadership of [Brian Onang'o](https://github.com/surgbc).

## License

UNLICENSED - Proprietary software for educational and research use.

## Support

- [Issues](https://github.com/gospelsounders/egw-writings-mcp/issues)
- [Documentation](https://github.com/gospelsounders/egw-writings-mcp#readme)
npm package: @surgbc/egw-writings-local-server
Description: MCP server providing fast access to local EGW Writings database
Author: Brian Onango
Latest version: 1.0.0

# @surgbc/egw-writings-local-server

MCP server providing fast access to local EGW Writings database for educational and research purposes.

## Overview

This Model Context Protocol (MCP) server provides high-performance access to a locally downloaded EGW Writings database. It offers millisecond search response times and works offline, making it ideal for research and educational applications.

## Features

- **Local Database**: No internet required after initial setup
- **High Performance**: Millisecond search response times with FTS5
- **Full-text Search**: Advanced search capabilities with highlighting
- **Reference Navigation**: Browse by EGW reference codes (e.g., "AA 15.1")
- **Context Retrieval**: Get surrounding paragraphs for better understanding
- **Statistics**: Database metrics and content overview
- **Offline Access**: Complete independence from API availability

## Installation

```bash
npm install -g @surgbc/egw-writings-local-server
```

## Prerequisites

You need a populated EGW writings database. Use the downloader tool first:

```bash
npx @surgbc/egw-writings-downloader quick-start
```

## Usage

### As MCP Server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "egw-local": {
      "command": "egw-local-server"
    }
  }
}
```

### Available Tools

- `search_local` - Full-text search with FTS5 highlighting
- `get_local_book` - Get book information from local database
- `get_local_content` - Retrieve paragraphs from books
- `list_local_books` - List available books with filters
- `browse_by_reference` - Find content by EGW reference (e.g., "AA 15.1")
- `get_context` - Get surrounding paragraphs for context
- `get_database_stats` - Database statistics and metrics

## Search Features

### Full-text Search
```
search_local "righteousness by faith"
```

### Reference Navigation
```
browse_by_reference "DA 123"
browse_by_reference "Great Controversy 45.2"
```

### Context Retrieval
```
get_context "para_id_123" --before 2 --after 2
```

## Performance Benefits

- **No Rate Limits**: Unlimited local queries
- **Fast Response**: Sub-millisecond search times
- **Offline Operation**: Works without internet connection
- **Full Content**: Complete database with all downloaded content
- **Advanced Search**: FTS5 with ranking and highlighting

## Educational and Research Use

This tool is designed for educational and research purposes. The EGW writings may be subject to copyright restrictions. Users are responsible for ensuring their use complies with applicable copyright laws and fair use guidelines.

## Organization

Developed by [Gospel Sounders](https://github.com/gospelsounders) under the leadership of [Brian Onang'o](https://github.com/surgbc).

## License

UNLICENSED - Proprietary software for educational and research use.

## Support

- [Issues](https://github.com/gospelsounders/egw-writings-mcp/issues)
- [Documentation](https://github.com/gospelsounders/egw-writings-mcp#readme)