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');

💻 使用示例

基础用法

以下是使用智能 MCP 的基本步骤示例：

// 示例代码：多线程任务分派
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!' }

高级用法

定义和执行复杂的工作流以及根据上下文选择工具等高级场景：

// 示例代码：定义和执行工作流
const workflow = {
    id: "data_processing",
    description: "数据处理工作流",
    steps: [
        { 
            id: "数据清洗", 
            type: "cleaner",
            parameters: { source: "db.csv" }
        },
        // 其他步骤...
    ]
};

const result = await mcp.executeWorkflow(workflow);

// 示例代码：根据上下文选择工具
const userContext = {
    message: "帮我生成一份季度报告",
    history: ["打开Excel", "查找数据"]
};

const selectedTools = await mcp.selectToolsForContext(userContext);

📦 安装指南

1. 启动服务器

运行主服务：

npm run server

2. 测试上下文感知选择器

执行测试脚本：

npm run test

3. 运行示例脚本

多个示例脚本用于演示不同功能：

# 测试 Gemini API 集成
node examples/gemini-example.js

# 测试上下文感知选择器
node test-context-aware-selector.js

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

🔌 可用工具集成

AI 工具

• Gemini API：Google 的生成式 AI 模型，支持文本生成、对话等。
• 分步推理：逐步推理工具。
• 网络搜索：网络搜索功能。

开发工具

• GitHub：仓库管理、问题跟踪、PR 创建。
• 文件系统：文件操作、代码编辑。
• 数据库：PostgreSQL 集成（计划中）。

内存工具

• 知识图谱：存储和检索结构化信息。
• 向量存储：半结构化搜索和检索。

📊 上下文感知工具选择

上下文感知选择器能够根据用户消息历史推荐最相关的工具，示例如下：

const userContext = {
    message: "优化代码性能",
    history: ["运行测试", "检查日志"]
};

const selectedTools = await mcp.selectRelevantTools(userContext);

📚 详细文档

📝 API 文档

1. 核心接口

• mcp.registerTool(name, func)：注册新工具。
• mcp.execute_tool(name, params?)：执行指定工具。
• mcp.selectRelevantTools(context)：根据上下文选择相关工具。
• mcp.executeWorkflow(workflow)：执行定义的工作流。

2. 扩展接口

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

🚀 开发与贡献

欢迎社区开发者参与项目开发，共同完善功能。我们期待你的贡献！

1. 代码仓库

克隆代码仓库并安装依赖：

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

2. 提交问题

在 GitHub Issues 中提交遇到的问题或建议。

3. 提交贡献

Fork 仓库，克隆后本地开发，完成后提出 Pull Request。

📄 许可证

项目遵循 MIT 许可证，具体条款见 LICENSE 文件。