Remnus

Remnus

人間とAIエージェントのための、オープンソースでMCPネイティブなワークスペースです。

Claude、Cursor、その他あらゆるAIエージェントがMCP経由で読み書きできるカンバンボード、データベース、ページを、あなたと一緒に使えます。

---

Remnusとは？

Remnusは、Model Context Protocol（MCP）を基盤とする、人間とエージェントが協働するワークスペースです。ワークスペース内のすべてのページ、データベース、カンバンボードに、専用のMCP サーバー経由でAIエージェントがアクセスできます。ワンクリックの OAuth 2.1（PKCE） でエディターを接続するか、ヘッドレス／CIエージェントにはスコープを限定した ベアラートークン を使用できます。

NotionのMCP連携とは異なり、Remnusは最初からヘッドレス、CI/CD、コーディングエージェントのワークフロー向けに設計されています。

ワークスペースのダンプではなく、OKFネイティブなコンテキスト

Remnusは、移植可能なナレッジの契約としてOpen Knowledge Format（OKF）の考え方を採用しています。ページには説明、タイプ、タグ、ソース、ライフサイクル状態、情報の鮮度を示す日付、リビジョンに紐づくレビューシグナルを含められます。OKF v0.2のインポート／エクスポートはデータ交換レイヤーであり、編集可能なRemnusワークスペースが正本です。

prepare_context MCPツールは、具体的なタスクをContext Pack v2に変換します。これは、BM25の関連度、ネイティブメタデータ、ページリンク、情報の鮮度、信頼度によって順位付けされた、トークン予算内のコンセプトセットです。Smartモードでは、意義のある作業に対して、このコンテキストファーストのフローが自動的に提示されます。Strictモードではさらに、Remnus MCPへの変更操作の前に、同じエージェントが発行した有効期間の短いcontextRunIdが必要です。

MCPサーバーがローカルファイル、シェルコマンド、Gitを制御できるようになるわけではありません。リポジトリレベルの適用には、提供されているAGENTS.mdとCLAUDE.mdのスニペットを使用します。公開されているContext-First MCPガイドと、実装の背景を紹介するRemnusがOKFを活用してAIエージェントにより良いコンテキストを提供する方法をご覧ください。

特長

• ページ — スラッシュコマンド、ネストされたサブページ、アイコンに対応したMarkdownエディター
• データベース — カスタマイズ可能な列、テーブル／カンバン／カレンダービュー、フィルター、並べ替え
• ダッシュボード — エージェントが数百トークンのJSONから構築でき、人間がブロックごとに編集できる、ライブステータス画面（指標、チャート、リスト、埋め込みビュー）
• MCP サーバー — ステートレスなStreamable HTTP経由で、28個のツール＋7個のリソース＋7個のプロンプトを提供
• OKFネイティブなコンテキスト — 移植可能なナレッジメタデータ、正確なリビジョンに対するレビュー、Context Pack v2、Smart／Strict MCPポリシー
• エージェント認証 — エディター向けのワンクリックOAuth 2.1＋PKCE（RFC 7591動的登録）、またはヘッドレスエージェント向けの読み取り／書き込みスコープ付き個人アクセストークン
• マルチワークスペース — メンバーの招待、ロールベースのアクセス（オーナー／メンバー／閲覧者）
• デスクトップアプリ — Windows、macOS、Linux向けのTauri v2シェル
• モバイル — iOSおよびAndroid向けのCapacitor v8（remnus.comを読み込みます）
• 国際化（i18n） — 英語、Türkçe、हिन्दी、Español、Français、Deutsch、中文、Русский

クイックスタート — セルフホスト

ローカル開発

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

http://localhost:3000を開きます。最初にサインアップしたユーザーは、自動的に管理者に昇格します。

Docker Compose（5 分でセットアップ）

Docker を使って Remnus を実行する場合：

1. リポジトリをクローンして、そのディレクトリに移動します：

   git clone https://github.com/Ranork/remnus-app.git
   cd remnus-app
   

2. 環境変数のテンプレートをコピーし、必要な変数（特に AUTH_SECRET と OAuth の認証情報）を設定します：

   cp .env.example .env
   

3. アプリケーションを起動します：

   docker compose up -d
   

4. http://localhost:3000 で Remnus にアクセスします。SQLite データベースは Docker ボリュームを使って自動的に永続化されます。

デプロイ

エディターに MCP を追加する

サインインしたら、サイドバーから AI Agents パネルを開き、Connect editor をクリックします。対応しているすべてのエディター（Cursor、VS Code、Claude Code、Codex、Windsurf など）の設定手順が表示されます。

レジストリからインストールする

Remnus は 公式 MCP Registry（io.github.Ranork/remnus）と Smithery に公開されているため、MCP 対応のクライアントやディレクトリから自動的に検出できます。Smithery では多くのクライアント（Claude、Cursor、VS Code、Codex、Windsurf など）にワンクリックでインストールできます。Smithery のページを開いて Add to toolbox をクリックするか、Smithery CLI を使ってクライアントの設定に直接インストールします：

npx -y smithery@latest mcp add ranorkk/remnus --client claude

--client を cursor、vscode、codex、windsurf などに置き換えてください。どちらの方法でも、最初の接続時に同じ OAuth 2.1 サインインが実行されます。貼り付けるトークンは不要です。

推奨 — OAuth（トークン不要）： エディターで MCP の URL を指定し、初回接続時に同意画面で承認します。エディターが OAuth 2.1 のフローを自動的に実行するため、コピーするものはありません。

{
  "mcpServers": {
    "remnus": {
      "type": "http",
      "url": "https://your-instance.com/api/mcp"
    }
  }
}

ヘッドレス／CI — 個人用アクセストークン： AI Agents パネルからスコープを限定したトークンを作成し、ベアラーヘッダーとして送信します。

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

MCP ツール

ツール	範囲	説明
prepare_context	read	Context Pack v2（BM25 + OKF メタデータ + グラフ）を構築し、有効期間の短い contextRunId を返します
search_workspace	read	ページとデータベースを横断して全文検索します
list_workspace	read	サイドバーの項目をページネーション付きで一覧表示します
get_page	read	ID を指定して、ページ、データベースの行、またはダッシュボードを（ブロック仕様として）取得します
get_pages	read	1 回の呼び出しで ID を指定して複数のページ／行を取得します（get_page の一括実行）
get_database_schema	read	データベースの列スキーマを取得します
query_database	read	フィルターとページネーションを指定して行をクエリします
list_members	read	ワークスペースのメンバーと役割を一覧表示します
query_audit_log	read	エージェントのアクティビティログを絞り込みます
get_changes_since	read	タイムスタンプまたはカーソル以降の変更を、時系列順の簡潔なフィードで取得します
get_related_pages	read	ページの親、子、外部リンク、バックリンク、データベース内の同じ階層の項目、ソースファイルを取得します。またはファイルパスを指定して、そのファイルを基盤とするページを取得します
get_status	read	この接続のワークスペース、範囲、トークンの有効期限、および対処方法を確認します
create_page	write	アイコン付きで、独立したページまたはデータベースの行を作成します
bulk_create_pages	write	1 回の呼び出しで最大 50 件のページまたは行を作成し、ref／parentRef を使ってページをネストします
update_page	write	タイトル、コンテンツ、またはプロパティを更新します
bulk_update_pages	write	1 回の呼び出しで複数の行を更新します
delete_page	write	ページ、データベース、ダッシュボード、または行を削除します（confirm: true が必要です）
bulk_delete_pages	write	1 回の呼び出しで最大 100 件のページ／行／データベースを削除します（confirm: true が必要です）
move_item	write	項目を新しい親に移動します
bulk_move_items	write	1 回の呼び出しで最大 100 件の項目を移動し、親の変更や、行の別のデータベースへの移動を行います
create_database	write	カスタムスキーマ、アイコン、ビューを指定してデータベースを作成します
update_database_schema	write	列を追加または削除します
create_database_view	write	テーブル／カンバン／カレンダービューを追加します
update_database_view	write	ビュー名を変更するか、設定を部分更新します
delete_database_view	write	保存済みのビューを削除します（confirm: true が必要です）
create_dashboard	write	JSON ブロックからライブダッシュボードを作成します。URL と、空で表示されるブロックに関する警告を返します
update_dashboard	write	ブロック ID でダッシュボードを部分更新します。追加、更新、削除、並べ替えが可能です
add_comment	write	ページまたは行にコメントを追加します（エージェントのコメントは追記専用です）

技術スタック

• フレームワーク： Next.js 16.2.6（App Router）
• データベース： Drizzle ORM + @libsql/client 経由の SQLite（Turso 互換）
• 認証： Auth.js v5 — Google および GitHub の OAuth
• スタイリング： Tailwind CSS + Lucide アイコン
• デスクトップ： Tauri v2（Rust）
• モバイル： Capacitor v8

コントリビューション

CONTRIBUTING.md を参照してください。バグ修正、新しい MCP ツール、翻訳、ドキュメントなど、あらゆる貢献を歓迎します。

ライセンス

AGPL-3.0 — 自由にセルフホストして変更できます。SaaS のフォークでは、変更点をオープンソースにする必要があります。