Softalleys Utilities MCP

Softlanes实用程序MCP服务器

一种模型上下文协议（MCP）服务器，为UUID生成、ULID生成、格式转换、UTC时间检索和随机字符串生成提供实用工具。

特性

此MCP服务器提供以下工具：

UUID工具

• generateuuid：生成随机UUID（版本4）
• generate_uid_v7：使用可选的datetime参数生成基于时间的UUID（版本7）
• uuid_to_ulid：将UUID v7转换为ULID

ULID工具

• 发电机ulid：使用可选的datetime参数生成基于时间的ULID
• ulid_to_uid：将ULID转换为UUID v7

时间工具

• current_utc：获取UTC（ISO 8601格式）中的当前时间

随机字符串工具

• generate_random_string：生成具有可自定义选项的随机字符串：

- 长度（默认值：10） - 包含大写字母（默认值：true） - 包含数字（默认值：true） - 包含特殊字符（默认值：true）

安装

使用npm

npm install -g softalleys-utilities-mcp

使用npx（无需安装）

npx softalleys-utilities-mcp

从源头构建

git clone 
cd softalleys-utilities-mcp
npm install
npm run build

用法

使用克劳德桌面

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

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "softalleys-utilities": {
      "command": "npx",
      "args": ["-y", "softalleys-utilities-mcp"]
    }
  }
}

或者，如果全局安装：

{
  "mcpServers": {
    "softalleys-utilities": {
      "command": "softalleys-utilities-mcp"
    }
  }
}

使用Docker

构建Docker镜像

docker build -t softalleys-utilities-mcp .

使用Docker运行

docker run -i softalleys-utilities-mcp

与Claude Desktop（Docker）一起使用

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

{
  "mcpServers": {
    "softalleys-utilities": {
      "command": "docker",
      "args": ["run", "-i", "softalleys-utilities-mcp"]
    }
  }
}

工具示例

生成UUID v4

Request: Use the generate_uuid tool
Response: "550e8400-e29b-41d4-a716-446655440000"

生成具有特定日期时间的UUID v7

Request: Use generate_uuid_v7 with datetime "2024-01-15T10:30:00Z"
Response: "018d2e4a-7a00-7000-8000-000000000000"

生成ULID

Request: Use generate_ulid
Response: "01HJ8X4Y9Z6M2K3N4P5Q6R7S8T"

将UUID v7转换为ULID

Request: Use uuid_to_ulid with uuid "018d2e4a-7a00-7000-8000-000000000000"
Response: "01HJ8X4Y9Z6M2K3N4P5Q6R7S8T"

获取当前UTC时间

Request: Use current_utc
Response: "2024-10-29T16:45:30.123Z"

生成随机字符串

Request: Use generate_random_string with length 16, includeUpperCase true, includeNumbers true, includeSpecialChars false
Response: "aB3dE5fG7hI9jK1l"

发展

先决条件

• Node.js 20或更高版本
• npm

设置

npm install

构建

npm run build

观看模式

npm run watch

技术细节

• 使用TypeScript构建
• 使用模型上下文协议SDK
• 通过以下方式生成UUID uuid 包裹
• 通过ULID生成 ulidx 包裹
• 遵循MCP规范进行工具注册和执行

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。