AI导哈

自动化集成工具包

MCP Server是一个功能强大的自动化集成工具包，提供19+内置工具，涵盖文件管理、数据库操作、邮件发送、PDF生成、QR码生成、AI/ML操作等多种功能。

  • by SERGE3-g
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 serge3-g/mcp-server

使用说明

🚀 MCP服务器-高级工具包

完整而强大的模型上下文协议 （MCP） 服务器，集成了 19 多个工具，可满足各种自动化和集成需求。

📋 概述

该 MCP 服务器提供了一个完整的工具生态系统，用于与 Claude AI 交互，提供从文件和数据库管理到发送实际电子邮件、生成 PDF 和 QR 代码以及高级 AI/ML 操作等功能。

✨ 主要特点

  • 19 集成工具 从文件管理到AI操作
  • 电子邮件SMTP Reali - 使用Gmail发送真实的电子邮件， Outlook， 雅虎
  • 真实的SQLite数据库 -数据库验证查询SQL
  • WebSocket实时 双向沟通
  • PDF 生成 - 发票，报告，文件
  • 二维码生成器 -WiFi、vCard、短信、URL
  • 系统插件 - 完全可扩展性
  • 智能缓存 - 性能优化
  • 速率限制 - 使用控制
  • Web 界面 - 控制面板
  • 高级 安全 - 验证和控制

🛠️ 安装

先决条件

  • Node.js 18+ （Windows/macOS/Linux）
  • sqlite3 （可选，用于实际数据库）
  • 克劳德桌面 已安装

快速设置

🍎 macOS/Linux：

# Clona il repository
git clone <repository-url>
cd mcp-server

# Installa dipendenze
npm install

# Configura automaticamente
./setup-claude.sh

# Avvia server
npm start

🪟 窗户：

REM Clona il repository
git clone <repository-url>
cd mcp-server

REM Installa dipendenze  
npm install

REM Configura automaticamente
setup-claude-windows.bat

REM Avvia server
npm start

配置

创建文件 .env 基于 .env.example:

# Configurazione Server MCP
MCP_SERVER_NAME=mcp-server
MCP_SERVER_VERSION=1.0.0

# Debug mode
DEBUG=false

# Dimensione massima file (in bytes)
MAX_FILE_SIZE=1048576

# Cache e Rate Limiting
CACHE_SIZE=100
RATE_LIMIT_WINDOW=60000
RATE_LIMIT_MAX=100

📚 可用工具

🔧 工具底座（5）

get_system_info

获取有关系统的详细信息。

{
  "name": "get_system_info",
  "arguments": {
    "detailed": true
  }
}

echo

连接测试 - 返回提供的文本。

list_files

浏览目录和文件。

read_file

读取文件内容。

execute_command

执行安全系统命令（白名单）。

🌐 测试工具（3）

http_request

客户端HTTP/HTTPS已完成。

{
  "name": "http_request",
  "arguments": {
    "url": "https://api.example.com",
    "method": "POST",
    "headers": {"Content-Type": "application/json"},
    "body": "{\"key\": \"value\"}"
  }
}

websocket_server

服务器WebSocket实时。

{
  "name": "websocket_server",
  "arguments": {
    "action": "start",
    "port": 8080
  }
}

📧 电子邮件工具（1）

email_operations

完整的电子邮件系统与真正的SMTP。

{
  "name": "email_operations",
  "arguments": {
    "operation": "send",
    "to": "destinatario@email.com",
    "subject": "Test Email",
    "body": "<h1>Email HTML</h1>"
  }
}

SMTP 配置 ：

// Prima configura il provider
{
  "operation": "configure_smtp",
  "provider": "gmail",
  "auth": {
    "user": "tua@gmail.com",
    "pass": "app-password"
  }
}

🤖 AI/ML工具（1）

ai_operations

人工智能操作。

{
  "name": "ai_operations",
  "arguments": {
    "operation": "sentiment",
    "text": "Questo prodotto è fantastico!"
  }
}

可用操作 ：

  • sentiment - 情绪分析
  • summarize - 文本摘要
  • classify - 分类
  • enhance 改进文本
  • detect_language 语言检测
  • similarity 文本之间的相似性

📊 数据工具（3）

json_tools

JSON/YAML 操作

csv_operations

完整的CSV/Excel处理。

{
  "name": "csv_operations",
  "arguments": {
    "operation": "parse",
    "data": "name,age\nMario,30\nLuigi,25",
    "options": {"hasHeader": true}
  }
}

sqlite_db

数据库SQLite完成。

{
  "name": "sqlite_db",
  "arguments": {
    "operation": "create_table",
    "table": "users",
    "columns": {"name": "TEXT", "email": "TEXT"}
  }
}

🔐 安全和文本工具（2）

crypto_tools

加密工具。

{
  "name": "crypto_tools",
  "arguments": {
    "operation": "hash",
    "data": "testo da hashare",
    "algorithm": "sha256"
  }
}

text_processing

高级文本处理。

📁 文件和Git工具（2）

file_operations

高级文件操作。

git_operations

Git 操作（只读）。

🎨 创意工具（1）

template_engine

有助手的模板引擎。

{
  "name": "template_engine",
  "arguments": {
    "operation": "render_string",
    "content": "Ciao {{name}}! Oggi è {{date \"DD/MM/YYYY\"}}",
    "data": {"name": "Mario"}
  }
}

🏥 系统工具（2）

health_check

服务器监控和指标。

plugin_manager

动态插件系统。

🔥 高级功能

📱 二维码生成器

生成不同用途的QR码：

// QR WiFi
qrTools.generateWiFiQR({
  ssid: "MiaRete",
  password: "password123",
  security: "WPA"
});

// QR vCard
qrTools.generateVCardQR({
  name: "Mario Rossi",
  phone: "+39123456789",
  email: "mario@email.com"
});

// QR URL
qrTools.generateURLQR("https://example.com");

📄 PDF生成器

创建专业的 PDF 文档：

// Fattura PDF
await pdfTools.createInvoice({
  number: "2024-001",
  date: "2024-01-15",
  customer: {
    name: "Cliente SpA",
    address: "Via Roma 1",
    city: "Milano",
    zip: "20100"
  },
  items: [
    {description: "Servizio", quantity: 1, price: 100, total: 100}
  ],
  total: 100
});

// Report PDF
await pdfTools.createReport({
  title: "Report Mensile",
  author: "Sistema",
  sections: [...]
});

🔧 系统插件

使用自定义插件扩展服务器：

// Plugin di esempio
export default {
  name: 'custom',
  version: '1.0.0',
  description: 'Plugin personalizzato',
  
  tools: [{
    name: 'my_tool',
    description: 'Il mio strumento',
    inputSchema: { /* schema */ }
  }],

  async execute(toolName, args) {
    // Logica del plugin
    return { content: [{ type: 'text', text: 'Risultato' }] };
  }
};

🌐 Web 界面

服务器包括一个完整的Web仪表板，可通过打开访问 web-interface.html:

  • 服务器控制 开始/停止/重新启动
  • 实时监控 - 指标和实时日志
  • 测试工具 - 测试所有工具的界面
  • 插件管理 - 上传/下载插件
  • WebSocket状态 - 连接状态

⚙️ 高级设置

发送邮件

支持主要提供商：

// Gmail (App Password richiesta)
{
  host: 'smtp.gmail.com',
  port: 587,
  secure: false,
  auth: { user: 'email@gmail.com', pass: 'app-password' }
}

// Outlook
{
  host: 'smtp-mail.outlook.com',
  port: 587,
  secure: false,
  auth: { user: 'email@outlook.com', pass: 'password' }
}

数据库SQLite

要使用真正的SQLite：

# macOS
brew install sqlite3

# Ubuntu/Debian
sudo apt-get install sqlite3

# Windows
# Scarica da https://sqlite.org/download.html

网络套接字

WebSocket 服务器支持：

  • 房间 - 通信渠道
  • 广播 - 留言给大家
  • 私人消息 - 直接消息
  • 存在 用户状态

🔒 安全

已实施的控制

  • 路径横向保护 - 只能访问当前目录
  • 命令白名单 只有安全命令
  • 速率限制 控制要求的频率
  • 输入验证 - 参数验证
  • 文件大小限制 - 文件大小控制
  • 错误处理 安全的错误管理

最佳实践

  1. 不提交凭据 -Usa文件 .env
  2. 应用程序密码 -每个Gmail的美国应用程序密码
  3. 防火墙 - 配置 WebSocket 防火墙
  4. 监控 - 监控日志和指标
  5. 备份 -备份regolari数据库

📖 使用范例

场景1：电子邮件营销

{
  "name": "email_operations",
  "arguments": {
    "operation": "create_template",
    "template_name": "newsletter",
    "template": {
      "subject": "Newsletter {{month}}",
      "htmlBody": "<h1>Ciao {{name}}!</h1><p>{{content}}</p>"
    }
  }
}

场景 2：自动报告

{
  "name": "sqlite_db",
  "arguments": {
    "operation": "select",
    "table": "sales",
    "where": {"month": "2024-01"}
  }
}

场景3：二维码菜单餐厅

qrTools.generateURLQR("https://menu.ristorante.com", {
  size: 300,
  errorCorrectionLevel: 'H'
});

场景 4：自动备份

{
  "name": "file_operations",
  "arguments": {
    "operation": "copy",
    "source": "./data",
    "destination": "./backup/data-2024-01-15"
  }
}

🤝 贡献者

  1. Fork del存储库
  2. Crea分支特征(git checkout -b feature/nome-feature)
  3. 修改提交（git commit -am 'Aggiunge feature')
  4. Push al分支(git push origin feature/nome-feature)
  5. Crea Pull请求

插件开发

创建一个新的插件：

  1. 创建文件 plugins/mio-plugin.js
  2. 实现插件界面
  3. 用下载 plugin_manager
  4. 功能测试

📊 演出

度量

  • 启动时间： <1秒
  • 内存使用情况： 50-100MB基础
  • 请求延迟： <100ms（缓存）
  • 并发请求： 100+同时
  • 文件处理： 1MB默认限制
  • 数据库： SQLite 优化

优化

  • 智能缓存 控制TTL
  • 连接池 数据库
  • 延迟加载 插件
  • 流处理 大文件
  • 压缩 网络套接字

🐛 故障排除

常见问题

未发送电子邮件 ：

  • SMTP 凭据验证
  • 每个Gmail的美国应用密码
  • 防火墙控制

SQLite无法工作：

  • 安装 sqlite3 系统 中
  • 检查数据库文件权限
  • 控制数据库路径

WebSocket 错误 ：

  • 检查可用端口
  • 防火墙控制
  • 检查邮件格式

插件未加载 ：

  • 检查 JavaScript 语法
  • 检查默认导出
  • 检查方案工具

📄 许可证

ISC许可证 - 详情请参阅许可证文件。

🙏 信用

  • MCP-SDK -人类学
  • Node.js -运行时JavaScript
  • 数据库 -嵌入式数据库
  • 社区 - 贡献和反馈

🚀 快速启动命令

# Sviluppo
npm run dev

# Produzione  
npm start

# Test tools
curl -X POST http://localhost:3000/health

# WebSocket test
wscat -c ws://localhost:8080

# Plugin test
node -e "console.log('Plugin loaded')"

🎯 准备与Claude AI一起使用 - 您的终极MCP服务器！

相关 MCP