Skip to main content
Glama
maple-awa

tool-mcp-server

by maple-awa
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

tool-mcp-server

npm version Publish

一个基于 Model Context Protocol (MCP) 的 stdio 服务端，将 tool-website 的在线工具能力以 MCP Tool 的形式暴露出来，供支持 MCP 的客户端调用。

说明：本项目中的工具实现移植自 https://github.com/sisi0318/tool-website。

功能特性

  • 58 个 MCP Tool：包含 54 个具体工具 + 4 个元工具

  • 8 大工具分类：基础、加密、数据、开发、图片、文本、实用、预览

  • Stdio 传输：标准 MCP stdio 协议，兼容 Claude Desktop、Cline、Windsurf 等客户端

  • 工作流支持：通过 run_workflow 将多个工具按有向图拓扑执行

  • 完整测试覆盖：单元测试、工具逻辑测试、MCP 协议调用测试全部通过

Related MCP server: OpenAI Agents MCP Server

一键使用

如果你已经安装了 Node.js，可以直接通过 npx 一键启动，无需克隆仓库：

npx -y tool-mcp-server

安装

方式一：通过 npm / pnpm 安装

pnpm add -g tool-mcp-server
# 或
npm install -g tool-mcp-server

方式二：本地开发

git clone https://github.com/maple-awa/tool-mcp.git
cd tool-mcp
pnpm install
pnpm build

MCP 客户端配置

Claude Desktop

编辑 claude_desktop_config.json：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tool-mcp-server": {
      "command": "npx",
      "args": ["-y", "tool-mcp-server"]
    }
  }
}

Cline / Roo Code

在 Cline 的 MCP Servers 设置中添加：

{
  "mcpServers": {
    "tool-mcp-server": {
      "command": "npx",
      "args": ["-y", "tool-mcp-server"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

本地开发配置

如果你使用本地构建产物：

{
  "mcpServers": {
    "tool-mcp-server": {
      "command": "node",
      "args": ["/path/to/tool-mcp/dist/index.js"]
    }
  }
}

使用

启动 MCP 服务

pnpm start

服务通过 stdio 与 MCP 客户端通信。

开发模式

pnpm dev

测试

# 全部测试
pnpm test:all

# 仅单元测试
pnpm test:unit

# 仅工具逻辑测试
pnpm test:tools

# 仅 MCP 协议测试
pnpm test:mcp

工具清单

分类

数量

示例

basic

5

string、number、json、file、boolean

crypto

8

hash、hmac、crypto、encoding、jwt、classic-cipher 等

data

12

json-format、json-path、protobuf、yaml-to-json、base64-to-file 等

dev

4

http-tester、crontab、docker-converter、whois

image

8

image-to-base64、exif-viewer、image-compress、qrcode、meme-splitter 等

text

4

text-stats、case-converter、regex、diff

utility

7

uuid、totp、color、base-converter、currency、bmi 等

viewer

6

device-info、office-viewer、time、string-preview、image-preview 等

完整的工具列表可通过 MCP 调用 list_tools 获取。

MCP 元工具

工具名

说明

list_tools

列出所有可用工具

get_tool_schema

获取指定工具的输入输出 schema

execute_tool

直接执行某个工具

run_workflow

按节点和边构建工作流并执行

每个具体工具也会以 tool_<type> 的形式注册，例如 tool_hash、tool_qrcode。

测试状态

  • ✅ TypeScript 编译通过

  • ✅ 单元测试：14 / 14 通过

  • ✅ 工具逻辑测试：54 / 54 通过

  • ✅ MCP 协议调用测试：58 / 58 通过

自动发布到 npm

本仓库配置了 GitHub Actions，在创建 Release 时会自动构建、测试并发布到 npm。

配置方法

  1. 在 npm 生成 Access Token（Publish 权限）

  2. 在 GitHub 仓库设置 → Secrets and variables → Actions 中添加 NPM_TOKEN

  3. 在 GitHub 创建 Release，Actions 会自动执行发布

手动发布

pnpm build
pnpm test:unit
pnpm publish --access public

项目结构

├── .github/workflows/        # GitHub Actions 工作流
├── src/
│   ├── index.ts              # MCP 服务入口
│   ├── lib/adapters/         # 各工具适配器实现
│   ├── lib/canvas/           # 节点注册表和工作流引擎
│   ├── mcp/                  # MCP schema、文件工具、工作流运行器
│   ├── test-all-tools.ts     # 工具逻辑集成测试
│   ├── test-mcp-all-tools.ts # MCP 协议集成测试
│   └── tool-test-cases.ts    # 共享测试用例
├── dist/                     # 编译输出
├── package.json
├── tsconfig.json
└── vitest.config.ts

许可证

MIT

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/maple-awa/tool-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server