Smart MCP Server

🚀 智能 MCP

智能 MCP（智能控制面板）是一個高度靈活且可擴展的平臺，支持多種工具和服務的集成。它能夠根據用戶需求和上下文信息，自動選擇並執行最佳工具組合。

✨ 主要特性

1. 多線程與任務處理

支持多線程任務分派，可並行執行多個任務。

// 示例代碼：多線程任務分派
import { SmartMCP } from './SmartMCP.js';

const mcp = new SmartMCP();

// 定義並註冊工具函數
const task1 = () => {
    return 'Task 1 completed!';
};

const task2 = () => {
    return 'Task 2 completed!';
};

mcp.registerTool('task1', task1);
mcp.registerTool('task2', task2);

// 並行執行任務
const result = await mcp.executeParallel(['task1', 'task2']);
console.log(result); // 輸出: { task1: 'Task 1 completed!', task2: 'Task 2 completed!' }

2. 任務流程系統

可定義和執行復雜的工作流，方便處理一系列任務。

// 示例代碼：定義和執行工作流
const workflow = {
    id: "data_processing",
    description: "數據處理工作流",
    steps: [
        { 
            id: "數據清洗", 
            type: "cleaner",
            parameters: { source: "db.csv" }
        },
        // 其他步驟...
    ]
};

const result = await mcp.executeWorkflow(workflow);

3. 上下文感知工具選擇

根據用戶的上下文信息，如消息歷史等，自動選擇最相關的工具。

// 示例代碼：根據上下文選擇工具
const userContext = {
    message: "幫我生成一份季度報告",
    history: ["打開Excel", "查找數據"]
};

const selectedTools = await mcp.selectToolsForContext(userContext);

4. 擴展插件支持

支持註冊和使用新的自定義工具，方便擴展系統功能。

// 示例代碼：註冊和使用新工具
const customTool = () => {
    return '自定義工具執行完成!';
};

mcp.registerPlugin('customTool', customTool);

const result = await mcp.execute_plugin('customTool');

💻 使用示例

基礎用法

啟動服務器

運行主服務：

npm run server

測試上下文感知選擇器

執行測試腳本：

npm run test

運行示例腳本

多個示例腳本用於演示不同功能：

# 測試 Gemini API 集成
node examples/gemini-example.js

# 測試上下文感知選擇器
node test-context-aware-selector.js

# 運行工作流示例
node examples/test-workflow.js

📦 安裝指南

克隆代碼倉庫

git clone https://github.com/SmartMCP/smart-mcp.git
cd smart-mcp
npm install

📚 詳細文檔

🔌 可用工具集成

AI 工具

• Gemini API：Google 的生成式 AI 模型，支持文本生成、對話等。
• 分步推理：逐步推理工具。
• 網絡搜索：網絡搜索功能。

開發工具

• GitHub：倉庫管理、問題跟蹤、PR 創建。
• 文件系統：文件操作、代碼編輯。
• 數據庫：PostgreSQL 集成（計劃中）。

內存工具

• 知識圖譜：存儲和檢索結構化信息。
• 向量存儲：半結構化搜索和檢索。

📊 上下文感知工具選擇

上下文感知選擇器根據用戶消息歷史推薦最相關的工具：

const userContext = {
    message: "優化代碼性能",
    history: ["運行測試", "檢查日誌"]
};

const selectedTools = await mcp.selectRelevantTools(userContext);

📝 API 文檔

核心接口

• mcp.registerTool(name, func)：註冊新工具。
• mcp.execute_tool(name, params?)：執行指定工具。
• mcp.selectRelevantTools(context)：根據上下文選擇相關工具。
• mcp.executeWorkflow(workflow)：執行定義的工作流。

擴展接口

• mcp.registerPlugin(name, func)：註冊插件。
• mcp.usePlugin(name)：使用指定插件。
• mcp.listPlugins()：列出所有可用插件。

🚀 開發與貢獻

歡迎社區開發者參與項目開發，共同完善功能。我們期待你的貢獻！

提交問題

在 GitHub Issues 中提交遇到的問題或建議。

提交貢獻

Fork 倉庫，克隆後本地開發，完成後提出 Pull Request。

📄 許可證

項目遵循 MIT 許可證，具體條款見 LICENSE 文件。