Archive/remem.me-server
1
Fork 0
mirror of https://gitlab.com/remem-me/server.git synced 2026-04-26 12:09:59 -03:00
Code Issues Projects Releases Packages Wiki Activity
Open Source replication server for the popular Bible memory app Remember Me, using Django
694 commits 3 branches 75 tags 1.4 MiB
  • Python 99.5%
  • Shell 0.5%
Find a file
Exact
pschaffl 711c03388f chore: split dev deps into requirements-dev.txt, ignore .vscode
2026-04-19 22:11:50 +02:00
.claude Add test environment settings and configuration files 2026-02-17 20:43:58 +01:00
.run #118: progress level limit reduced 2025-10-20 19:05:27 +02:00
access Remove ATOMIC_REQUESTS from all settings and wrap critical operations in explicit transactions 2026-04-12 06:19:49 +00:00
doc subscribable collections plan updated 2025-12-12 17:05:47 +01:00
main Remove ATOMIC_REQUESTS from all settings and wrap critical operations in explicit transactions 2026-04-12 06:19:49 +00:00
mcp_server #144: Add custom route for serving server.json in MCP server 2026-03-28 17:34:21 +01:00
misc #45: link address added 2024-02-11 16:11:21 +01:00
rm_replication Remove ATOMIC_REQUESTS from all settings and wrap critical operations in explicit transactions 2026-04-12 06:19:49 +00:00
.gitignore chore: split dev deps into requirements-dev.txt, ignore .vscode 2026-04-19 22:11:50 +02:00
.gitlab-ci.yml chore: split dev deps into requirements-dev.txt, ignore .vscode 2026-04-19 22:11:50 +02:00
assembleDjangoPo #14: dependencies updated 2021-04-24 08:02:35 +02:00
CLAUDE.md #144: Add OpenAPI schema annotations and mcp server 2026-03-28 06:26:04 +01:00
CODE_OF_CONDUCT.md #6: open source documents added 2020-09-18 10:49:16 +02:00
CONTRIBUTING.md #13: paginated requests 2021-02-27 14:37:44 +01:00
LICENSE.txt #6: open source documents added 2020-09-18 10:49:16 +02:00
manage.py Add production settings, environment variable loading, and dotenv dependency 2026-02-17 07:50:31 +01:00
newrelic-alerts-setup.md admin page performance improved 2026-02-12 21:46:09 +01:00
newrelic.ini collection query performance 2025-11-02 15:01:03 +01:00
post-receive #144: Add OpenAPI schema annotations and mcp server 2026-03-28 06:26:04 +01:00
pytest.ini #100: exclude streaks from high scores 2025-05-23 21:23:16 +02:00
README.md #144: Add OpenAPI schema annotations and mcp server 2026-03-28 06:26:04 +01:00
requirements-dev.txt chore: split dev deps into requirements-dev.txt, ignore .vscode 2026-04-19 22:11:50 +02:00
requirements.txt chore: split dev deps into requirements-dev.txt, ignore .vscode 2026-04-19 22:11:50 +02:00

README.md

Remember Me Replication Server

Replication server for the Bible memorization app Remember Me

Getting started

Configuration

The server requires the following environment variables for deployment:

  • WEB_APP_BASE_URL - Base URL of the frontend web application
    • Used for password reset links, activation emails, and redirects
    • Format: Full URL with protocol (http or https)
    • Allowed domains: localhost, *.local, *.remem.me
    • Examples: https://web.remem.me, http://localhost:3000
    • Default: https://web.remem.me

For a complete list of configuration options, see CLAUDE.md.

MCP Server

The project includes an MCP server that exposes public Bible verse collections to AI agents. Three read-only tools are available:

  • browse_collections — Search and filter published collections by keyword, language, or popularity
  • get_collection_detail — Get full collection with all verse text, references, and topics
  • get_collection_metrics — Community engagement stats (progress, mastery, activity)

Local development

python manage.py run_mcp

Starts the MCP server on http://127.0.0.1:8001/mcp (Streamable HTTP transport).

Production deployment (Alwaysdata)

The MCP server runs as a separate site on Alwaysdata alongside the main Django WSGI app.

  1. In the Alwaysdata admin panel, create a new site:

    • Type: User program
    • Command: cd ~/rm_replication && venv/bin/python manage.py run_mcp --host 0.0.0.0 --port 8001 --settings=rm_replication.settings.prod
    • Domain: mcp.remem.me

  2. Add the new site's ID to the post-receive hook as MCP_SITE_ID so it restarts on deploy.

Need help?

Please use the user forum for help requests and how-to questions. Please open Gitlab issues for bugs and enhancements only, not general help requests.

Want to contribute?

If you want to contribute through code or documentation, the Contributing guide is the best place to start. If you have questions, feel free to ask.

Want to support us?

If you want to support us financially, you can help fund the project through a Paypal donation.