MCP Toolkit V1

生产力工具包MCP服务器

一个全面的模型上下文协议（MCP）服务器，为开发人员和高级用户提供基本的生产力工具。该服务器提供对密码生成、QR码创建、Base64编码/解码、UUID生成和调色板工具的安全、API-key验证访问。

特性

🔐 密码生成器 -使用可定制的选项创建安全密码 📱 二维码工具 -生成二维码和格式化数据串 🔄 Base64转换器 -使用Base64对文本进行编码和解码 🆔 UUID生成器 -生成唯一标识符（UUID v4） 🎨 调色板生成器 -为设计项目创建漂亮的配色方案

快速开始

先决条件

• Node.js 16+
• npm或纱线
• OpenSSL（用于生成API密钥）

安装

1. 克隆仓库

   git clone https://github.com/ForgeSynapse/mcp-toolkit-v1.git
   cd mcp-toolkit-v1

1. 安装依赖项

   npm install

1. 生成API密钥

   openssl rand -hex 32

1. 设置环境变量

   export MCP_API_KEY="your_generated_api_key_here"

1. 运行服务器

   npx ts-node server.ts

工具参考

🔐 密码生成器

生成具有可定制复杂性的安全密码。

工具: generate-password

参数:

• apiKey （字符串，必填）-身份验证密钥
• length （数字，可选）-密码长度（8-128，默认值：16）
• includeNumbers （布尔值，可选）-包括数字（默认值：true）
• includeSymbols （布尔值，可选）-包含符号（默认值：true）
• includeUppercase （布尔值，可选）-包含大写字母（默认值：true）
• includeLowercase （布尔值，可选）-包含小写字母（默认值：true）

示例:

{
  "apiKey": "your_api_key",
  "length": 20,
  "includeSymbols": true,
  "includeNumbers": true
}

📱 二维码数据生成器

为各种二维码类型创建格式化数据字符串。

工具: generate-qr-data

参数:

• apiKey （字符串，必填）-身份验证密钥
• type （枚举，必填）-二维码类型： wifi, contact, url, text
• data （对象，必填）-键入特定数据字段

WiFi二维码数据:

{
  "apiKey": "your_api_key",
  "type": "wifi",
  "data": {
    "ssid": "MyNetwork",
    "password": "mypassword",
    "security": "WPA"
  }
}

联系二维码数据:

{
  "apiKey": "your_api_key",
  "type": "contact",
  "data": {
    "name": "John Doe",
    "phone": "+1234567890",
    "email": "john@example.com"
  }
}

📱 二维码生成器

生成多种格式的实际二维码。

工具: generate-qr-code

参数:

• apiKey （字符串，必填）-身份验证密钥
• text （字符串，必填）-要编码的文本
• format （枚举，可选）-输出格式： png, svg, terminal （默认值：png）
• errorCorrectionLevel （枚举，可选）-错误更正： L, M, Q, H （默认值：M）
• width （数字，可选）-二维码宽度（像素）（100-1000，默认值：200）

示例:

{
  "apiKey": "your_api_key",
  "text": "https://example.com",
  "format": "png",
  "width": 300
}

🔄 Base64转换器

使用Base64编码对文本进行编码或解码。

工具: base64-convert

参数:

• apiKey （字符串，必填）-身份验证密钥
• operation （枚举，必填）-操作类型： encode 或 decode
• text （字符串，必填）-要处理的文本

示例:

{
  "apiKey": "your_api_key",
  "operation": "encode",
  "text": "Hello, World!"
}

🆔 UUID生成器

生成唯一标识符（UUID v4）。

工具: generate-uuid

参数:

• apiKey （字符串，必填）-身份验证密钥
• count （number，可选）-要生成的UUID数量（1-10，默认值：1）

示例:

{
  "apiKey": "your_api_key",
  "count": 5
}

🎨 调色板生成器

为设计项目创建调色板。

工具: generate-color-palette

参数:

• apiKey （字符串，必填）-身份验证密钥
• baseColor （字符串，可选）-十六进制格式的基色（#RRGGBB）
• type （枚举，可选）-调色板类型： monochromatic, complementary, triadic, random （默认值：随机）
• count （数字，可选）-颜色数量（3-10，默认值：5）

示例:

{
  "apiKey": "your_api_key",
  "baseColor": "#3498db",
  "type": "monochromatic",
  "count": 6
}

发展

项目结构

ice-cream-mcp-server/
├── server.ts           # Main MCP server implementation
├── package.json        # Dependencies and scripts
├── tsconfig.json       # TypeScript configuration
├── README.md          # This file
├── DEPLOYMENT.md      # Deployment guide
└── CLAUDE.md          # Development instructions

地方发展

1. 安装依赖项

   npm install

1. 设置环境

   export MCP_API_KEY="$(openssl rand -hex 32)"

1. 自动重新加载运行

   npx ts-node --watch server.ts

1. TypeScript编译

   npx tsc

建筑

• MCP服务器：内置 @modelcontextprotocol/sdk
• 运输：用途 StdioServerTransport 用于通信
• 认证：所有工具的API密钥验证
• TypeScript：完全键入Zod模式验证

部署

渲染（推荐）

看 部署.md 获取完整的部署说明。

快速部署以渲染:

1. 将GitHub存储库连接到Render
2. 创建新的Web服务
3. 设置构建命令： npm install
4. 设置启动命令： npx ts-node server.ts
5. 添加环境变量： MCP_API_KEY=your_key

其他平台

此MCP服务器可以部署到支持以下功能的任何平台：

• Node.js运行时
• 长时间运行的流程
• 环境变量
• stdin/stdout通信

安全

API关键要求

所有工具都需要通过身份验证 apiKey 参数。服务器根据 MCP_API_KEY 环境变量。

最佳实践

• 使用生成强API密钥 openssl rand -hex 32
• 永远不要将API密钥提交到版本控制
• 定期旋转API键
• 使用环境变量进行配置
• 监控服务器日志以查找可疑活动

使用示例

与Claude Desktop一起使用

将此服务器添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "productivity-toolkit": {
      "command": "npx",
      "args": ["ts-node", "/path/to/server.ts"],
      "env": {
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

与MCP客户端一起使用

import { Client } from '@modelcontextprotocol/sdk/client/index.js';

const client = new Client({
  name: "productivity-client",
  version: "1.0.0"
});

// Call password generator tool
const result = await client.callTool("generate-password", {
  apiKey: "your_api_key",
  length: 16,
  includeSymbols: true
});

贡献

1. 复刻仓库
2. 创建要素分支： git checkout -b feature-name
3. 进行更改
4. 如果适用，添加测试
5. 提交您的更改： git commit -am 'Add feature'
6. 推到分支： git push origin feature-name
7. 提交拉取请求

许可证

该项目根据ISC许可证获得许可。

支持

• 为bug或功能请求创建问题
• 检查 部署.md 获取部署帮助
• 查看服务器日志以进行故障排除

更新日志

v1.0.0

• 初始版本
• 密码生成器工具
• 二维码数据生成工具
• 二维码生成工具
• Base64转换器工具
• UUID生成器工具
• 调色板生成器工具
• API密钥验证
• 渲染部署支持