int

セルフホスト型、Docker化された、オープンソースのAIメモリシステムです。Model Context Protocol (MCP) を介して、プロジェクトスコープのメモリストアをAIコーディングアシスタントに公開し、アシスタントが高コストな探索作業を再実行することなく、以前のセッションでの学びを思い出せるようにします。

ステータス

v1は進行中です。仕様は docs/spec.md、意図は docs/intent.md、タスクの内訳は tasks/todo.md にあります。

Related MCP server: AIVectorMemory

クイックスタート

cp .env.example .env          # fill in API_KEY and GEMINI_API_KEY
docker compose up -d          # server + Qdrant
docker compose logs -f int    # tail server

opencode.json にリモートMCPエントリを追加して、OpenCodeをサーバーに接続します:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "int": {
      "type": "remote",
      "url": "http://localhost:8000/mcp",
      "headers": { "API_KEY": "{env:API_KEY}" }
    }
  }
}

完全なセットアップ、CLIの使用方法、および一般的な落とし穴については、docs/deployment.md を参照してください。

ツール

ツール名はそのままです（add、search、...）。MCPサーバーは int として登録されているため、MCPクライアントは int_add、int_search、int_list、 int_delete として公開します。

スタック

Python 3.14、FastAPI + MCP（mcp Python SDK、Streamable HTTP）、Qdrant（別コンテナ）、gemini-embedding-001（MRL経由でL2正規化された768次元）、Docker Compose、依存管理のための uv。

ライセンス

Apache-2.0 — 詳細は LICENSE を参照してください。