mcpField
M
MarsNMe

MarsNMe

ローカル
marsnme.comメモリ・ナレッジ71 週間前に更新
リポジトリ公式サイト

MarsNMe について

MarsNMeは、MCP Gatewayを通じて記憶ツールを提供するエージェント向けバックエンドです。Supabaseにデータを保存し、Jinaによるセマンティック検索で人とAIの継続的な文脈を支えます。

主な機能

  1. 01ストリーミングHTTPでMCPを提供
  2. 02Supabaseによる記憶データ管理
  3. 03埋め込みベースのセマンティック検索
  4. 04ヘルスステータスエンドポイント

活用シーン

  1. 01AIエージェントのセッション間で記憶を保持
  2. 02保存した記憶を意味から検索

MCP 対応

ストリーミングHTTPを使い、`/mcp` でMCPクライアントに記憶ツールを公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "marsmanleo-marsnme": {
      "command": "npx",
      "args": [
        "-y",
        "@marsnme/mcp-gateway"
      ],
      "env": {
        "MCP_PROFILE": "<MCP_PROFILE>",
        "SUPABASE_BASE_URL": "<SUPABASE_BASE_URL>",
        "SUPABASE_SERVICE_ROLE_KEY": "<SUPABASE_SERVICE_ROLE_KEY>",
        "JINA_API_KEY": "<JINA_API_KEY>",
        "PORT": "<PORT>"
      }
    }
  }
}
起動コマンドnpx -y @marsnme/mcp-gateway
設定が必要な環境変数
MCP_PROFILEProfile ID used to separate memory data (for example: profile-a).
SUPABASE_BASE_URLSupabase REST API project URL.
SUPABASE_SERVICE_ROLE_KEYシークレットSupabase service role key.
JINA_API_KEYシークレットJina AI API key for embedding-based tools.
PORTLocal HTTP port for the MCP endpoint. If omitted, defaults by MCP_PROFILE (coco=18790, toto=18791, others deterministic in 20000-29999).

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@marsnme/mcp-gateway0.3.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

@marsnme/mcp-gateway

MarsNMe のデモ

ストリーミング可能な HTTP トランスポートを使用した、メモリーツール向けの MarsNMe MCP ゲートウェイです。

このパッケージは POST /mcp で MCP サーバーを実行し、GET /health でヘルスステータスを公開します。

要件

  • Node.js >=20
  • 必須のスキーママイグレーションを適用した Supabase プロジェクト
  • 埋め込みベースのメモリー検索に必要な Jina API キー

クイックスタート（npx）

MCP_PROFILE=coco \
SUPABASE_BASE_URL=https://<your-project-ref>.supabase.co \
SUPABASE_SERVICE_ROLE_KEY=<your-service-role-key> \
JINA_API_KEY=<your-jina-api-key> \
npx -y @marsnme/mcp-gateway

起動後：

  • ヘルスチェック：http://127.0.0.1:18790/health
  • MCP エンドポイント：http://127.0.0.1:18790/mcp

必須の環境変数

  • MCP_PROFILE
    • ^[a-z][a-z0-9_-]*$ に一致する小文字のプロファイル ID（例：coco、toto、my-agent）
    • レガシーの組み込み ID：coco と toto
  • SUPABASE_BASE_URL
    • Supabase REST プロジェクトの URL
  • SUPABASE_SERVICE_ROLE_KEY（推奨）または SUPABASE_SERVICE_KEY
    • データベース操作に使用するサービスロールキー
  • JINA_API_KEY
    • セマンティック検索／埋め込み機能に必要です

よく使われるオプションの環境変数

  • PORT
    • ゲートウェイが使用する HTTP ポートを上書きします
    • 省略した場合、ゲートウェイはプロファイルに基づくデフォルト値を解決します：
      • coco → 18790
      • toto → 18791
      • その他のプロファイル ID → 20000-29999 の範囲で決定されるポート
  • MCP_REQUIRE_BEARER
    • MCP 呼び出しで Authorization: Bearer <token> を必須にするには、true に設定します
  • MCP_OAUTH_ENABLED
    • OAuth エンドポイントはデフォルトで有効です（無効にするには false に設定します）
  • MCP_CLIENT_ID と MCP_CLIENT_SECRET
    • オプションの静的 OAuth クライアント認証情報

最小限の検証

サービスのヘルス状態を確認します：

curl -sS http://127.0.0.1:18790/health

ツールを一覧表示します：

curl -sS http://127.0.0.1:18790/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

デプロイの安全性ゲート（再起動前）

アップグレードでは、明示的に DDL を実行できるロールでデータベースマイグレーションを実行し、サービスを再起動する前にスキーマの互換性を確認してください。

推奨するロールの指針：

  • 対象スキーマで DDL を実行できるロールを使用してください。
  • Supabase がホストする Postgres では、通常 postgres ではなく supabase_admin を使用します。

スキーマゲートコマンド：

bash deploy/phase2/pre_deploy_schema_gate.sh \
  --db-url "<postgres://supabase_admin:<password>@<host>:5432/postgres>" \
  --profiles coco,toto \
  --expected-role supabase_admin
  • ゲートがゼロ以外の終了コードを返した場合は、デプロイを中止し、サービスを再起動しないでください。

データベースのセットアップとオンボーディングの全手順

マイグレーションとセットアップの詳細については、以下を参照してください：

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。