Proyecto independiente No afiliado, patrocinado ni avalado por la Watch Tower Bible and Tract Society o Jehovah's Witnesses.
jw-agent-toolkit
EN

Paquete · Librería

jw-mcp

Puente con tu agente

El componente que convierte el toolkit en algo que tu agente de IA puede usar. Implementado con FastMCP, expone cada parser y cliente de jw-core (más el RAG, los agentes, el second-brain F49+F66, los loaders externos F62, la memoria persistente F61, el ASR diarizado F64, la reunión-en-vivo F57 y toda la capa F65-F76 agéntica + multimodal + predictivo + voz familiar consentida) como tools accesibles vía el protocolo MCP estándar. Funciona sobre stdio para Claude Desktop/Code o sobre SSE para otros clientes. F71 añade además REST endpoints opt-in mountables sobre FastAPI: jw_mcp.rest.book_camera.router expone POST /api/v1/book_camera/{analyze, tts, rag_answer}.

Funcionalidades

Lo que hace, en detalle.

01

~135 herramientas registradas

resolve_reference · get_chapter · get_daily_text · search_content · get_article · get_verse · get_study_notes · get_cross_references · compare_translations · list_languages · download_publication · jwpub_extract · topic_subjects · ... más 5 finetune tools.

02

F57-F66 tools (16 nuevas)

second_brain_status/query/compile/lint/snapshot (F49+F66) · ingest_pdf + ingest_office_doc (F62) · transcribe_audio_diarized (F64) · memory_record/recall/forget_session + recap_previous_session (F61+F61.8) · meeting_discover_week/download_media/list_programs/open_presenter/list_congregations/add_congregation (F57+F57.16). Plus drift fix _EXPECTED_TOOLS (get_trace F43 + translate_preserving_refs F54).

03

F65-F76 tools (15+ nuevas) + REST endpoints

Meta-orchestrator F65: meta_plan/run/replay. Sparring F66: spar_personas/start/turn/close (memoria SQLite cross-process opt-in). Reasoner F67: doctrinal_reason. Talk-lab F68: talklab_analyze + history/compare. Broadcasting visual F69: visual_index + visual_search. Image-quote F70: verify_image_quote. Book-camera F71: book_camera_analyze + REST jw_mcp.rest.book_camera.router (POST /api/v1/book_camera/{analyze,tts,rag_answer} — opt-in via APIRouter.include_router). Drift F72: drift_analyze. Voice-clone F76: voice_clone_list/synthesize/audit (license gate 3 capas + Fernet opt-in via JW_VOICE_KEY).

04

Agentes high-level

verse_explainer · research_topic · meeting_helper · apologetics. Cada uno orquesta múltiples llamadas y devuelve findings citables.

05

RAG global

El único componente que liga el RAG: search_corpus busca sobre todo el contenido indexado (Biblia + artículos + EPUB + JWPUB) con BM25 + vector + RRF.

06

Setup en Claude Desktop

Una entrada en claude_desktop_config.json apuntando a 'uv run jw-mcp'. Reinicia Claude Desktop y ya tienes 100+ tools nuevas en tus conversaciones.

En la práctica

Cuatro líneas.
Resultado verificable.

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/).

json · jw-mcp
{
  "mcpServers": {
    "jw": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/jw-agent-toolkit",
        "run",
        "jw-mcp"
      ]
    }
  }
}

API pública

Qué exporta el módulo.

Resumen de los símbolos principales. La referencia exhaustiva cubre cada uno con signature, parámetros y ejemplos.

  • ~135 MCP tools sobre stdio
  • Resources: file://jw/...
  • Agentes: verse_explainer · research_topic · ...
  • RAG: search_corpus con BM25 + vector + RRF
  • Brain: second_brain_* · Meeting: meeting_*
  • Memory: memory_record/recall + recap_previous_session
  • Meta F65: meta_plan/run/replay · Sparring F66: spar_*
  • Reasoner F67 · Talk-lab F68 · Visual F69 · Image-quote F70
  • Book-camera F71 + REST jw_mcp.rest.book_camera.router
  • Drift F72 · Voice-clone F76 (license gate + Fernet opt-in)