MD5-MCP：MD5哈希计算器MCP提供者

一个用于从各种数据类型计算MD5哈希值的模型上下文协议（MCP）提供者。 此提供者提供从字符串、JSON数据和base64编码的二进制数据计算MD5哈希值的工具。

特性

• 从纯文本字符串计算MD5哈希值，并可选择去除空格
• 从各种JSON数据类型（字符串、数字、布尔值、对象、数组）计算MD5哈希值
• 从base64编码的二进制数据计算MD5哈希值
• 控制格式化选项（例如保留空格或JSON格式）
• 易于与Claude和其他MCP兼容的客户端集成

安装

NPM全局安装（推荐）

# 全局安装
npm install -g md5-mcp

# 直接运行提供者
md5-mcp

本地安装

# 在您的项目中本地安装
npm install md5-mcp

# 添加到您的package.json脚本中
# "scripts": {
#   "start-md5": "md5-mcp"
# }

手动安装

# 克隆仓库
git clone https://github.com/tanker327/md5-mcp.git
cd md5-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 启动提供者
npm start

用法

启动提供者

如果全局安装：

md5-mcp

如果本地安装：

npx md5-mcp

这将使用stdio传输启动MCP提供者，这允许它与像Claude for Desktop这样的MCP客户端一起使用。

使用Claude for Desktop配置

将以下内容添加到您的Claude for Desktop配置中：

{
    "mcpServers": {
        "md5-calculator": {
            "command": "npx",
            "args": ["md5-mcp"]
        }
    }
}

如果全局安装，您可以简化为：

{
    "mcpServers": {
        "md5-calculator": {
            "command": "md5-mcp"
        }
    }
}

可用工具

1. calculateMD5

从字符串输入计算MD5哈希值。

参数：

• input (string): 用于计算MD5哈希值的字符串
• trimWhitespace (boolean, optional): 是否在哈希之前从输入中删除空格（默认值：false）

示例：

@md5-calculator calculateMD5 --input="Hello, World!" --trimWhitespace=false

2. calculateJSONMD5

从JSON数据计算MD5哈希值。

参数：

• jsonData (any JSON type): 要哈希的JSON数据（字符串、数字、布尔值、对象或数组）
• preserveFormatting (boolean, optional): 是否保留JSON格式或在哈希之前压缩它（默认值：true）

示例：

@md5-calculator calculateJSONMD5 --jsonData={"name": "John", "age": 30} --preserveFormatting=true

3. calculateBase64MD5

从base64编码的二进制数据计算MD5哈希值。

参数：

• base64Data (string): 用于计算MD5哈希值的Base64编码的二进制数据

示例：

@md5-calculator calculateBase64MD5 --base64Data="SGVsbG8sIFdvcmxkIQ=="

关于MD5哈希的重要说明

• MD5对每个字符都很敏感，包括空格。 带有和不带有尾随空格的字符串将产生不同的哈希值。
• 当哈希JSON对象时，格式（缩进、换行符等）会影响哈希值。 使用preserveFormatting选项来控制此行为。
• MD5不再被认为是用于敏感应用程序的密码学安全算法。 它适用于数据完整性检查，但不适用于安全关键型应用程序。

编程API

您也可以在Node.js应用程序中以编程方式使用此软件包：

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

// 创建一个将提供者作为子进程启动的传输
const transport = new StdioClientTransport({
    command: "npx",
    args: ["md5-mcp"],
});

// 创建一个客户端
const client = new Client(
    { name: "my-app", version: "1.0.0" },
    { capabilities: { resources: {}, prompts: {}, tools: {} } }
);

// 连接到提供者
await client.connect(transport);

// 计算MD5哈希值
const result = await client.callTool({
    name: "calculateMD5",
    arguments: {
        input: "Hello, World!",
        trimWhitespace: false,
    },
});

console.log(result.content[0].text);

// 完成后不要忘记断开连接
await client.disconnect();

开发

在开发模式下运行

npm run dev

这将在监视模式下启动TypeScript，并在文件更改时自动重新编译。

运行测试

npm test

发布到npm

要发布新版本：

# 更新package.json中的版本
npm version patch # 或 minor, 或 major

# 发布到npm
npm publish

prepublishOnly脚本将在发布之前自动运行测试并构建项目。

许可证

MIT

贡献

欢迎贡献！ 请随时提交Pull Request。