Model Context Lab

🚀 vpursuit的MCP生態系統

本單倉庫項目包含了模型上下文協議（MCP）的相關包和產品，這些包和產品能讓AI助手與SWI - Prolog、文件系統以及可擴展的插件系統協同工作。

🚀 快速開始

面向終端用戶

安裝完整的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服務器

這是一個MCP服務器，它允許支持工具的大語言模型（LLMs）與SWI - Prolog交互。它支持加載Prolog文件、添加/刪除事實和規則、列出符號，並且可以通過兩種模式運行查詢：確定性分頁模式。

• NPM：@vpursuit/swipl-mcp-server
• 文檔：products/swipl-mcp-server
• 快速啟動：npx @vpursuit/swipl-mcp-server

特性：

• 知識庫管理（加載、斷言、撤銷、轉儲）
• 兩種查詢模式：標準模式（call_nth/2）和引擎模式（真正的回溯）
• 專業的Prolog輔助提示（例如解決邏輯謎題）
• 全面的安全沙箱
• 動態文件系統根目錄
• 基於插件的架構

📦 安裝指南

前提條件

• 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
• 貢獻指南 — 開發工作流程和指南
• 安全 — 安全策略和漏洞報告

🔧 技術細節

架構

本倉庫遵循產品/插件架構：

• 產品 (products/)：終端用戶安裝的已發佈包（例如，@vpursuit/swipl-mcp-server）
• 插件 (plugins/)：集成在產品中的內部可重用組件（不單獨發佈）

內部插件系統

MCP服務器採用模塊化插件架構構建。這些插件是集成到主產品中的內部依賴項：

注意：這些插件是內部依賴項，會被打包到@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
• 擁有LICENSE（BSD - 3 - 條款）
• 擁有自己的測試套件

📄 許可證

本單倉庫中的所有包均採用BSD - 3 - 條款許可證。 詳情請參閱LICENSE文件。

🔗 鏈接

• GitHub：vpursuit/model-context-lab
• NPM組織：@vpursuit
• 模型上下文協議：modelcontextprotocol.io
• SWI - Prolog：swi-prolog.org

有疑問？ 請創建一個問題，或者查看我們的文檔。