convez.ai
MCP Server
Ranork

remnus-app

Ranork/remnus-app

Ver no GitHub
BomPluginScore · de 0 a 100

MCP Native Workspace (Databases, pages, kanbans, calendars etc.)

Instalação

$npx convez-ai Ranork/remnus-app

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
75
Forks
14
Acompanhando
3
Saúde
100%
Último commit
há 1 mês
Versão
v0.1.20
Issues abertas
1
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

Remnus

Open-source MCP-native workspace for humans and AI agents.

Kanban boards, databases, and pages that Claude, Cursor, and any AI agent can read and write via MCP — alongside you.

GitHub Stars License: AGPL-3.0 Deploy with Vercel


What is Remnus?

Remnus is a Notion-like workspace built around the Model Context Protocol (MCP). Every page, database, and kanban board in your workspace is accessible to AI agents via a first-class MCP server — using a simple bearer token, with no OAuth dance required.

Unlike Notion's MCP integration, Remnus is designed for headless, CI/CD, and coding agent workflows from day one.

Features

  • Pages — Markdown editor with slash commands, nested sub-pages, and icons
  • Databases — Customizable columns, Table / Kanban / Calendar views, filters, sorts
  • MCP Server — 15 tools + 4 resources + 5 prompts, Streamable HTTP + SSE dual transport
  • Multi-workspace — Invite members, role-based access (owner / member / viewer)
  • Desktop app — Tauri v2 shell for Windows, macOS, Linux
  • Mobile — Capacitor v8 for iOS and Android (loads remnus.com)
  • i18n — English, Türkçe, Español, Français, Deutsch, हिन्दी

Quick Start — Self-host

Local Development

git clone https://github.com/Ranork/remnus-app.git
cd remnus-app
cp .env.example .env          # fill in AUTH_SECRET + OAuth credentials
npm install
npm run db:migrate
npm run dev

Open http://localhost:3000. The first user to sign up is auto-promoted to admin.

Docker Compose (5-minute setup)

If you prefer to run Remnus using Docker:

  1. Clone the repository and navigate into it:
    git clone https://github.com/Ranork/remnus-app.git
    cd remnus-app
    
  2. Copy the environment template and fill in the required variables (especially AUTH_SECRET and OAuth credentials):
    cp .env.example .env
    
  3. Start the application:
    docker compose up -d
    
  4. Access Remnus at http://localhost:3000. The SQLite database will be persisted automatically using a Docker volume.

Deploy

Deploy to Vercel Deploy to Railway

Add MCP to your editor

After signing in, go to Workspace Settings → Tokens and create a token, then:

Add to Cursor Add to VS Code

Or add manually to your MCP client config:

{
  "mcpServers": {
    "remnus": {
      "type": "http",
      "url": "https://your-instance.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

MCP Tools

ToolScopeDescription
searchreadFull-text search across pages and databases
list_workspacereadList sidebar items with pagination
get_pagereadGet a page or database row by ID
get_database_schemareadGet column schema of a database
query_databasereadQuery rows with filters and pagination
list_membersreadList workspace members with roles
query_audit_logreadFiltered agent activity log
create_pagewriteCreate a standalone page or database row
update_pagewriteUpdate title, content, or properties
bulk_updatewriteUpdate multiple rows in one call
delete_pagewriteDelete a page (requires confirm: true)
move_itemwriteMove item to a new parent
create_databasewriteCreate a database with custom schema
update_database_schemawriteAdd or remove columns

Tech Stack

  • Framework: Next.js 15 (App Router)
  • Database: SQLite via Drizzle ORM + @libsql/client (Turso-compatible)
  • Auth: Auth.js v5 — Google & GitHub OAuth
  • Styling: Tailwind CSS + Lucide icons
  • Desktop: Tauri v2 (Rust)
  • Mobile: Capacitor v8

Contributing

See CONTRIBUTING.md. All contributions are welcome — bug fixes, new MCP tools, translations, and docs.

License

AGPL-3.0 — free to self-host and modify. SaaS forks must open-source their changes.

Ver o original no GitHub

Bom para

Relacionados