Skip to main content

offline-mcp

offline-mcp Glama score smithery badge

Install: pip install offline-mcp · Use with any MCP client.

Local AI inference infrastructure — Ollama wrapper, open weights directory, degraded-mode guide for East Africa.

PyPI Thesis Layer

Why: Never assume OpenAI survives, Anthropic stays accessible, or export controls disappear. This matters more in Africa than anywhere else.

1st world equivalent: Ollama, LLaMA, Mistral local deployment

Why This Exists: Data Sovereignty

"If you take the deal, you're going to be exploited. If you don't take it, you're going to die."
— Frank Ssekamwa, Ugandan digital rights expert

Across the Global South, AI and health data from communities is being extracted, processed abroad, and used to build models whose value flows away from the communities that generated it.

offline-mcp is the sovereignty floor of the East Africa coordination stack.

When this runs on a Raspberry Pi 4 with a 50W solar panel and a 256GB SD card:

  • Health data stays in the clinic. Health guidance comes from local models.
  • Land records stay in the land office. Queries don't touch foreign servers.
  • Civic data stays in the county. AI assistance runs without internet.

No API key. No cloud dependency. No data leaving the community.

The models available via offline-mcp (Llama 3.2, Qwen 2.5) run entirely on device. Community data used to generate AI outputs creates no dataset sent back to model providers.

This is not a privacy feature. It is the architectural foundation of digital independence.


Research Foundation

This server implements patterns validated by peer-reviewed research on offline-first AI for bandwidth-constrained environments:

arXiv:2603.03339 (2026) — Offline-First LLM Architecture for Adaptive Learning in Low-Connectivity Environments — confirms that meaningful AI support is achievable with hardware-aware model selection when designed for infrastructure-limited deployment. Key finding: offline-first is a complementary paradigm, not a compromise.

Design principles applied:

  • Local-first: all core operations execute without internet connectivity
  • Graceful degradation: reduced functionality beats no functionality
  • JSONL queue: events accumulated offline sync when connectivity returns
  • Hardware-aware: tool selection adapts to available compute

East Africa context: Kenya, Tanzania, Uganda — rural areas with intermittent connectivity represent the primary deployment target. This server is not designed for ideal conditions. It is designed for real ones.

Install

pip install offline-mcp

Tools (6)

Tool Description
check_ollama_status Check if Ollama is running locally and list available models
run_local_inference Run a prompt through a local Ollama model
list_recommended_models Best open-weight models for East Africa use cases
degraded_mode_guide 4-level degraded mode architecture for offline operation
open_weights_directory Directory of open-weight models with Africa language support
local_deployment_guide Deployment guide for laptop, server, Raspberry Pi, Android

Context

Runs on a 50W solar panel + Raspberry Pi 4. Viable for rural Kenya clinics, schools, and community offices.

→ The Nairobi Stack

License

MIT © Gabriel Mahia | contact@aikungfu.dev

Part of the East Africa Coordination Stack

This MCP server is part of the Kenya coordination infrastructure. Connect it to africa-coord-bus — the coordination event bus that routes signals between domains automatically.

pip install africa-coord-bus

All servers: pypi.org/user/gmahia Live demo: coord-cascade-demo

IP & Collaboration

MIT licensed. Feedback via GitHub Issues only — pull requests are not accepted. Demo data is labeled DEMO and is not suitable for operational decisions. Full policy: docs/architecture/IP_POLICY.md. Security reports: see SECURITY.md.

Part of the East Africa coordination stack

Model-agnostic by design: closed APIs, open-weight models, and small distilled models are all first-class citizens.

Metadata

Release files for offline-mcp 0.1.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for offline-mcp 0.1.10
File Size Uploaded Provenance Actions
offline_mcp-0.1.10.tar.gz 14.3 kB With provenance Details for offline_mcp-0.1.10.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for offline-mcp 0.1.10
File Interpreter ABI Platform Actions
offline_mcp-0.1.10-py3-none-any.whl Python 3 none any Details for offline_mcp-0.1.10-py3-none-any.whl

Total release size: 25.0 kB

Release files / offline_mcp-0.1.10.tar.gz

Download URL offline_mcp-0.1.10.tar.gz
Size 14.3 kB
Tags Source
SHA-256 checksum
How to use checksums
81c8e396cfa1a9dd9fcaa56b21f0a36792b721d2669bbb32880bb368ca78cb88
BLAKE2b-256 checksum
How to use checksums
f2aadc3a8385d4b953719b76552b2eee8372c1392ed873e432253390000ff303
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / offline_mcp-0.1.10-py3-none-any.whl

Download URL offline_mcp-0.1.10-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c63fe9d47b447f1ca0b655f217f4406750dafa4176bbfba36c05178f43f43f2a
BLAKE2b-256 checksum
How to use checksums
5392785838a92038e94d813be52c7396abec5f46e406d6eb2d274042d1035fb9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for offline-mcp 0.1.10

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for offline_mcp-0.1.10.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page