MCP Thought Server

🚀 MCP 思考サーバー使用説明

MCP 思考サーバーは、特定の機能を提供するサーバーで、必要な依存関係をインストールし、適切な環境変数を設定することで起動できます。

🚀 クイックスタート

📦 インストール

1. 依存関係のインストール

プロジェクトのルートディレクトリで以下のコマンドを実行して、すべての必要な依存関係をインストールします。

npm install

2. サーバーの起動

サーバーを起動するには、以下の3つの一般的な方法があります。

方法一：npx を使用して起動

以下のコマンドを直接実行すると、サーバーが起動します。

npx ts-node src/index.ts

方法二：ビルドして起動

まずプロジェクトをビルドし、次にビルド後のファイルを起動します。

npm run build
npm start

方法三：Docker コンテナを使用して起動（下記の Docker サポートのセクションを参照）

3. 環境変数の設定

サーバーを実行するために必要な環境変数とその説明は以下の通りです。

🔧 エラー処理と一般的な問題

1. "Original draft X not found" エラー

このエラーは、以前のドラフトレコードを取得できないことを示します。以下の点を確認してください。

• データベースファイルのパス（MCP_SQLITE_PATH またはデフォルトのパス data/mcp-thought-server.sqlite）が正しいこと。
• サーバープロセスがデータベースファイルが存在するディレクトリとファイルに書き込み権限を持っていること。
• データベースファイルが破損している疑いがある場合は、古い .sqlite ファイルを削除して新しい空のデータベースを再構築することができます。ただし、この操作により履歴データが失われることに注意してください。

2. LLM 一貫性チェックの問題

一貫性チェックを有効にする場合は、以下の設定が正しいことを確認してください。

• COHERENCE_API_KEY：有効な API キーが含まれていること。
• COHERENCE_CHECK_MODEL：構造化された JSON 出力をサポートするモデル ID が指定されていること。
• 外部の LLM サービスが正常に動作していること。

一貫性チェックを無効にするには、関連する環境変数の設定を削除またはコメントアウトします。

3. 低信頼度スコア

低信頼度スコアの原因としては、以下のものが考えられます。

• AI の出力内容がコンテキストのセマンティクスと一致しない（セマンティック類似度スコアの部分を確認）。
• 一貫性チェックが有効になっているが、モデルの出力が一貫していない。
• ツールに提供される context パラメータが不足しているか、定義が曖昧である。

4. 埋め込みモデルのダウンロード失敗

サーバーを初めて実行する際には、必要な埋め込みモデルをダウンロードするためにインターネット接続が必要です。また、キャッシュディレクトリの権限を確認してください。

npm run download-models

🐳 Docker サポート

1. イメージのビルド

プロジェクトのルートディレクトリで以下のコマンドを実行して、Docker イメージをビルドします。

docker build -t mcp-thought-server .

2. コンテナの実行

以下のコマンドを使用して、MCP 思考サーバーのコンテナを起動します。

基本的な起動

docker run --name mcp-thought-container -it mcp-thought-server

環境変数を設定してポートをバインドする

docker run --name mcp-thought-container \
    -e LOG_LEVEL=info \
    -e TRANSPORT=http \
    -p 3000:3000 \
    -it mcp-thought-server

3. コンテナの停止と削除

実行中のコンテナを停止します。

docker stop mcp-thought-container

停止したコンテナを削除します。

docker rm mcp-thought-container

📚 付録：環境変数の参照

サーバーがサポートするすべての環境変数とその詳細な説明は以下の通りです。

その他の質問やさらなる支援が必要な場合は、プロジェクトのドキュメントを参照するか、メンテナンスチームに連絡してください。