Model Context Lab

🚀 vpursuitによるMCPエコシステム

このモノレポジトリには、AIアシスタントがSWI-Prolog、ファイルシステム、および拡張可能なプラグインシステムと連携できるようにするモデルコンテキストプロトコル（MCP）のパッケージと製品が含まれています。

🚀 クイックスタート

エンドユーザー向け

完全なMCPサーバーをインストールします。

npx @vpursuit/swipl-mcp-server

モノレポ開発者向け

プラグインシステムを使って作業します。

git clone https://github.com/vpursuit/model-context-lab.git
cd model-context-lab
npm install
npm run build

コントリビューター向け

開発環境をセットアップします。

git clone https://github.com/vpursuit/model-context-lab.git
cd model-context-lab
npm install
npm run build
npm test

✨ 主な機能

SWI-Prolog MCPサーバー

Prologの知識ベースを統合した全機能のMCPサーバー

ツール対応の大規模言語モデル（LLM）がSWI‑Prologと直接連携できるMCPサーバーです。Prologファイルの読み込み、事実やルールの追加/削除、シンボルの一覧表示、および決定論的ページネーションと真のエンジンバックトラッキングの2つのモードでのクエリ実行をサポートしています。

• NPM: @vpursuit/swipl-mcp-server
• ドキュメント: products/swipl-mcp-server
• クイックスタート: npx @vpursuit/swipl-mcp-server

機能:

• 知識ベース管理（読み込み、追加、削除、ダンプ）
• 2つのクエリモード：標準（call_nth/2）とエンジン（真のバックトラッキング）
• 高度なPrologアシスタントプロンプト（例：論理パズルの解決）
• 包括的なセキュリティサンドボックス
• 動的なファイルシステムルート
• プラグインベースのアーキテクチャ

🔧 技術詳細

アーキテクチャ

このリポジトリはproducts/pluginsアーキテクチャに従っています。

• 製品 (products/)：エンドユーザーがインストールする公開パッケージ（例：@vpursuit/swipl-mcp-server）
• プラグイン (plugins/)：製品にバンドルされる内部の再利用可能なコンポーネント（個別に公開されません）

内部プラグインシステム

MCPサーバーはモジュール式のプラグインアーキテクチャで構築されています。これらのプラグインはメイン製品にバンドルされる内部依存関係です。

注意: これらのプラグインはpackage.jsonでprivateとマークされており、@vpursuit/swipl-mcp-serverにバンドルされています。個別にnpmに公開されません。

開発者向けプラグインシステム

このモノレポジトリ内で開発している場合は、直接プラグインシステムを使用できます。

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { loadPlugins } from '@vpursuit/mcp-server-core';
import { plugin as prologPlugin } from '@vpursuit/mcp-server-prolog';
import { plugin as rootsPlugin } from '@vpursuit/mcp-server-roots';

const server = new McpServer({
  name: 'my-mcp-server',
  version: '1.0.0',
});

// プラグインを読み込む
await loadPlugins(server, [prologPlugin, rootsPlugin]);

📂 リポジトリ構造

これはnpmワークスペースで管理されるモノレポジトリです。各パッケージは独立して開発、テスト、および公開できます。

model-context-lab/
├── products/
│   └── swipl-mcp-server/    # メインのMCPサーバー（npmに公開）
├── plugins/
│   └── server/
│       ├── core/            # プラグインシステムの基礎（内部）
│       ├── prolog/          # SWI-Prologの統合（内部）
│       └── roots/           # ファイルシステムルートの検出（内部）
├── docs/                    # モノレポレベルのドキュメント
├── .archive/                # 過去の戦略文書
└── package.json             # ワークスペース構成

各パッケージには以下があります。

• 独立したバージョン管理のpackage.json
• 完全なドキュメントのREADME.md
• BSD-3-ClauseのLICENSE
• 独自のテストスイート

🔧 開発

前提条件

• Node.js ≥ 20.0.0
• SWI-Prolog（Prolog統合のテスト用）
• npm ≥ 9.0.0

セットアップ

# リポジトリをクローンする
git clone https://github.com/vpursuit/model-context-lab.git
cd model-context-lab

# すべての依存関係をインストールする
npm install

# すべてのパッケージをビルドする
npm run build

# すべてのテストを実行する
npm test

パッケージの操作

# 特定のパッケージをビルドする
npm run build -w plugins/server/core

# 特定のパッケージをテストする
npm test -w plugins/server/prolog

# すべてのビルドアーティファクトをクリーンする
npm run clean

パッケージ開発

各パッケージは以下をサポートしています。

• npm run build - TypeScriptのコンパイル
• npm run clean - ビルドアーティファクトの削除
• npm test - Vitestテストの実行
• npm run test:watch - テストのウォッチモード

📚 ドキュメント

製品ドキュメント (swipl-mcp-server)

• インストールとセットアップ — すべてのMCPクライアントの完全なセットアップ
• 設定 — ファイルシステムルート、環境変数
• トラブルシューティング — 一般的な問題とデバッグモード
• 機能リファレンス — 詳細なプロンプト、リソース、およびツールのドキュメント
• 例 — コピーアンドペーストで使える使用例
• アーキテクチャ — コンポーネント、モード、およびワイヤプロトコル
• ライフサイクル — サーバーのライフサイクル、状態、および永続化パターン
• デプロイメント — リリース、パッケージング、およびソースからのインストール

モノレポドキュメント

• 公開ガイド — パッケージをnpmに公開する方法
• コントリビュートガイド — 開発ワークフローとガイドライン
• セキュリティ — セキュリティポリシーと脆弱性報告

🤝 コントリビュート

コントリビューションを歓迎します！以下の内容についてはCONTRIBUTING.mdを参照してください。

• 行動規範
• 開発ワークフロー
• テスト要件
• プルリクエストプロセス
• コーディング標準

セキュリティ問題については、SECURITY.mdを参照してください。

🚀 公開

@vpursuitスコープの下で製品のみがnpmに公開されます。

• 製品（例：@vpursuit/swipl-mcp-server）はエンドユーザー向けにnpmに公開されます。
• プラグインは製品にバンドルされる内部依存関係です（個別に公開されません）。
• リリースにはセマンティックバージョニングが使用されます：v<version>（例：v3.0.0）
• GitHub Actionsによる自動公開
• サプライチェーンセキュリティ：すべてのパッケージはnpmのプロベナンスアテステーションで公開されます。 完全な詳細についてはPUBLISHING.mdを参照してください。

🔒 セキュリティ

すべてのパッケージはセキュリティのベストプラクティスを実装しています。

• ファイルパス制限
• 危険な述語のブロッキング
• 実行前の検証
• タイムアウト保護
• モジュール分離

サプライチェーンセキュリティ:

• ビルドの透明性のためにnpmのプロベナンスアテステーションで公開
• OIDCベースの公開（長期トークンなし）
• Sigstoreによる暗号化署名パッケージ

完全なセキュリティドキュメントと報告についてはSECURITY.mdを参照してください。

📄 ライセンス

このモノレポジトリ内のすべてのパッケージはBSD-3-Clauseライセンスの下で提供されています。 詳細についてはLICENSEファイルを参照してください。

🔗 リンク

• GitHub: vpursuit/model-context-lab
• NPM Organization: @vpursuit
• Model Context Protocol: modelcontextprotocol.io
• SWI-Prolog: swi-prolog.org

質問はありますか？ issueを開くか、ドキュメントを参照してください。