Void MCP Server

Void MCP Server

このプロジェクトは、LLM のコンテキストデータを保存および取得するための Model Context Protocol（MCP）サーバーを提供します。軽量な Hugging Face モデルを実行する run_local.py と、シンプルな Streamlit UI を提供する app.py が含まれています。

クイックスタート

1. 前提条件をインストールする

   • Node.js と npm
   • Python 3.11
   • PostgreSQL（サービスが実行中であることを確認してください）

2. 依存関係をインストールする

   npm install          # Node packages
   pip install -r requirements.txt
   

3. データベースを設定する

   プロジェクトのルートに .env ファイルを作成し、少なくとも次の変数を設定します。

   DATABASE_HOST=localhost
   DATABASE_PORT=5432
   DATABASE_NAME=llm_context_db
   DATABASE_USER=your_db_user
   DATABASE_PASSWORD=your_db_password  # must be a string
   PORT=3000
   JWT_SECRET=change-me-in-production-min-32-chars
   

   DATABASE_PASSWORD が設定されていない場合、次のエラーが表示されます。 SASL: SCRAM-SERVER-FIRST-MESSAGE: client password must be a string.

4. サーバーをビルドする

   npm run build
   

5. すべてを実行する

   python start.py
   

   MCP API は http://localhost:3000、ローカルモデルサーバーは http://localhost:8000 で利用できます。停止するには Ctrl+C を押します。

6. 任意：Streamlit インターフェースを起動する

   streamlit run app.py
   

開発のヒント

• pytest と npm test でテストを実行します。

• python run_local.py --model sshleifer/tiny-gpt2 --port 8000 でローカルモデルのみを起動します。

• pre-commit run --all-files でフォーマットと lint を実行します。

• 必要に応じて、setup.sh で対話形式のデータベース設定を行えます。

• 依存関係のインストール

  • Node：npm install
  • Python：pip install -r requirements.txt

• ビルド：npm run build

• テスト：Node では npm test、Python では pytest

• ローカルモデルの実行：python run_local.py --model sshleifer/tiny-gpt2 --port 8000

• Streamlit UI：streamlit run app.py

ワンクリック起動

MCP サーバーとローカルモデルサーバーを一度に起動するには、次を実行します。

python start.py

start.py スクリプトはクロスプラットフォーム対応で、不足している Node と Python の依存関係をインストールし、必要に応じて TypeScript サーバーをビルドしてから、 MCP サーバーとローカルモデルサーバーを起動します。Unix 系システムでは、 ./start.sh も使用できます。

このスクリプトは不足している Node の依存関係をインストールし、必要に応じてサーバーをビルドしてから、MCP サービスとローカルモデルサーバーを起動します。IDE やツールと簡単に統合できるよう、接続情報がターミナルに表示されます。

IDE 統合

IDE のコンテキスト機能を MCP サーバーに接続するには、このリポジトリ内の start.py を指定する ide_config.json のような設定ファイルを用意します。

/path/to/Void-MCP-Server/start.py を、ご使用のシステム上の絶対パスに置き換えます。

{
  "context_servers": {
    "my-mcp-server": {
      "command": {
        "path": "python",
        "args": [
          "/path/to/Void-MCP-Server/start.py"
        ],
        "env": {}
      },
      "settings": {}
    }
  }
}

python start.py --help を実行すると、--model、--port、--model-port など、サーバーをカスタマイズするためのオプションを確認できます。