记忆服务器

# GitHubからクローン（または手動でファイルをダウンロード）
git clone <repository-url>
cd memory-server-mcp

# 仮想環境を作成
python -m venv venv

# 仮想環境を有効化
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# 必要なパッケージをインストール
pip install -r requirements.txt

# 3つのサーバーを同時起動（初回実行時にデータベースが自動作成されます）
python main.py

INFO - Memory Server starting...
INFO - Database initialized at: memory.db
INFO - 🔧 MCP Server: http://localhost:8000
INFO - 🌐 WebUI Server: http://localhost:8001  
INFO - 🚀 API Server: http://localhost:8002
INFO - All servers started successfully!

# MCP Server（メイン）のヘルスチェック
curl http://localhost:8000/health

# API Server の動作確認
curl http://localhost:8002/health

# WebUI にブラウザでアクセス
# http://localhost:8001

# EXE版
./dist/MemoryServerMCP.exe

# Python版
python main.py

# REST APIのみ起動（開発・テスト用）
python main.py --api-only

# 設定確認モード
python main.py --check-config

{
  "mcpServers": {
    "memory-server": {
      "command": "path/to/MemoryServerMCP.exe",
      "args": [],
      "env": {
        "MEMORY_LOG_LEVEL": "WARNING"
      },
      "disabled": false,
      "autoApprove": [
        "add_note_to_memory",
        "search_memory",
        "get_project_rules",
        "list_all_memories"
      ]
    }
  }
}

{
  "mcpServers": {
    "memory-server": {
      "command": "python",
      "args": ["path/to/your/main.py"],
      "cwd": "path/to/your/memory-server-mcp",
      "env": {
        "MEMORY_SERVER_HOST": "localhost",
        "MEMORY_SERVER_PORT": "8000",
        "MEMORY_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": [
        "add_note_to_memory",
        "search_memory", 
        "get_project_rules",
        "list_all_memories",
        "update_memory_entry",
        "delete_memory_entry"
      ]
    }
  }
}

# サーバー設定
export MEMORY_SERVER_HOST=localhost
export MEMORY_SERVER_PORT=8000

# データベース設定
export MEMORY_DB_PATH=memory.db

# ログ設定
export MEMORY_LOG_LEVEL=INFO
export MEMORY_LOG_FILE=memory_server.log

# 検索設定
export MEMORY_MAX_SEARCH_RESULTS=100

{
  "id": 1,
  "content": "メモリの内容",
  "tags": ["プロジェクト", "ルール"],
  "keywords": ["Python", "FastAPI"],
  "summary": "短い要約",
  "created_at": "2025-01-01T00:00:00",
  "updated_at": "2025-01-01T00:00:00"
}

# 全テストを実行（推奨）
python -m pytest

# 個別テストの実行
python test_server_startup.py          # 基本的なサーバー起動テスト
python test_full_server_startup.py     # 完全なサーバー起動テスト
python test_memory_service.py          # データアクセス層テスト
python test_mcp_tools.py               # MCPツール機能テスト
python test_mcp_integration.py         # MCP統合テスト
python test_api.py                     # REST APIテスト

# カバレッジレポート付きテスト（pytest-covがインストールされている場合）
python -m pytest --cov=main --cov-report=html

fastapi>=0.104.0        # 高速なWeb APIフレームワーク
uvicorn>=0.24.0         # ASGIサーバー
fastmcp>=0.1.0          # MCPプロトコル実装
pydantic>=2.0.0         # データバリデーション
pytest>=7.0.0           # テストフレームワーク
jinja2>=3.0.0           # WebUIテンプレートエンジン
python-multipart>=0.0.6 # マルチパートフォーム処理
httpx>=0.25.0           # 非同期HTTPクライアント

memory-server-mcp/
├── 📁 配布用ファイル
│   ├── dist/MemoryServerMCP.exe          # EXE配布版（42MB）
│   └── MemoryServerMCP.spec              # PyInstallerビルド設定
├── 📁 コアサーバーファイル
│   ├── main.py                           # MCPサーバー（ポート8000）
│   ├── webui_server.py                   # WebUIサーバー（ポート8001）
│   ├── api_server.py                     # APIサーバー（ポート8002）
│   └── requirements.txt                  # Python依存関係
├── 📁 WebUI関連
│   ├── templates/                        # HTMLテンプレート
│   │   ├── base.html                     # ベーステンプレート
│   │   ├── index.html                    # メイン画面
│   │   ├── create.html                   # 作成フォーム
│   │   ├── edit.html                     # 編集フォーム
│   │   └── error.html                    # エラー画面
│   └── static/                           # 静的ファイル
│       ├── css/style.css                 # スタイルシート
│       └── js/app.js                     # JavaScript
├── 📁 ビルド関連
│   ├── build_windows_exe.py              # EXE版ビルドスクリプト
│   └── pyinstaller_hooks/                # PyInstallerフック
├── 📁 テストファイル群
│   ├── test_api.py                       # REST APIテスト
│   ├── test_memory_service.py            # データアクセス層テスト
│   ├── test_mcp_tools.py                 # MCPツールテスト
│   ├── test_mcp_integration.py           # MCP統合テスト
│   ├── test_server_startup.py            # サーバー起動テスト
│   └── test_full_server_startup.py       # 完全起動テスト
├── 📁 データと設定
│   ├── memory.db                         # SQLiteデータベース
│   ├── memory_server.log                 # ログファイル
│   ├── mcp_config_cursor.json            # Cursor設定例
│   └── 要件.md                          # プロジェクト要件
└── 📁 その他
    ├── README.md                         # このドキュメント
    └── .git/                            # Gitリポジトリ

# 解決方法: 各ポートを変更
export MEMORY_SERVER_PORT=8100    # MCPサーバー
export MEMORY_WEBUI_PORT=8101     # WebUIサーバー  
export MEMORY_API_PORT=8102       # APIサーバー
python main.py

# 解決方法: ファイル権限を確認・修正
chmod 644 memory.db
# または、別の場所にデータベースを作成
export MEMORY_DB_PATH=/tmp/memory.db

# 解決方法: 検索結果数を制限
export MEMORY_MAX_SEARCH_RESULTS=50

# リアルタイムでログを監視
tail -f memory_server.log

# エラーレベルのログのみ表示
grep "ERROR\|CRITICAL" memory_server.log

# 最新の100行を表示
tail -n 100 memory_server.log

# デバッグレベルでログを出力
export MEMORY_LOG_LEVEL=DEBUG
python main.py

# CursorでLLMに以下のように指示
"このプロジェクトでは、Pythonのコーディング規約としてPEP8を厳密に守り、型ヒントを必須とする、というルールをメモリに保存してください"

"FastAPIとSQLiteを使用する理由は軽量性とポータビリティを重視するため、という決定をメモリに保存してください"

# LLMは自動的に保存されたルールを参照して回答
"新しいAPIエンドポイントを作成したいのですが..."
# → LLMは保存されたコーディング規約に基づいて提案

# メモリエントリを作成（API Server使用）
curl -X POST "http://localhost:8002/memories" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "プロジェクトではPEP8を厳密に守る",
    "tags": ["ルール", "コーディング規約"],
    "keywords": ["PEP8", "Python", "コーディング"],
    "summary": "Pythonコーディング規約の方針"
  }'

# キーワードで検索
curl "http://localhost:8002/memories/search?q=PEP8"

# タグで検索
curl "http://localhost:8002/memories/tags/ルール"

# WebUI経由でのAPI呼び出し
curl "http://localhost:8001/api/memories"

# データベースファイルをコピー
cp memory.db memory_backup_$(date +%Y%m%d).db

# 設定ファイルも含めてバックアップ
tar -czf memory_server_backup.tar.gz memory.db memory_server.log .kiro/

# 1. プロジェクトファイルをコピー
scp -r memory-server-mcp/ user@newmachine:/path/to/destination/

# 2. 新しいマシンで依存関係をインストール
cd /path/to/destination/memory-server-mcp/
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

# 3. サーバーを起動
python main.py