MCP Tools CLI

基本能力

产品定位

MCP Tools 是一个用于与 Model Context Protocol (MCP) 服务器交互的命令行工具，旨在简化 MCP 服务器的使用和管理。

核心功能

• 发现和调用 MCP 服务器提供的工具
• 访问和利用 MCP 服务器暴露的资源
• 创建模拟服务器用于测试客户端应用程序
• 代理 MCP 请求到 shell 脚本以实现轻松扩展
• 创建交互式 shell 以探索和使用 MCP 服务器
• 支持多种输出格式（JSON、美化打印、表格）
• 支持所有传输方法（HTTP、stdio）

适用场景

• 开发 MCP 服务器客户端应用程序
• 测试 MCP 服务器功能
• 扩展 MCP 服务器功能
• 探索和使用 MCP 服务器

工具列表

• version: 打印版本信息
• tools: 列出 MCP 服务器上可用的工具
• resources: 列出 MCP 服务器上可用的资源
• prompts: 列出 MCP 服务器上可用的提示
• call: 调用 MCP 服务器上的工具、资源或提示
• get-prompt: 获取 MCP 服务器上的提示
• read-resource: 读取 MCP 服务器上的资源
• shell: 启动 MCP 命令的交互式 shell
• mock: 创建带有工具、提示和资源的模拟 MCP 服务器
• proxy: 代理 MCP 工具请求到 shell 脚本
• scan: 扫描各种应用程序中可用的 MCP 服务器
• alias: 管理 MCP 服务器别名
• new: 创建新的 MCP 项目组件
• help: 获取任何命令的帮助
• completion: 为指定的 shell 生成自动完成脚本

常见问题解答

• 如何安装 MCP Tools？
• 使用 Homebrew：brew tap f/mcptools 和 brew install mcp
• 从源代码安装：go install github.com/f/mcptools/cmd/mcptools@latest
• 如何列出 MCP 服务器上的工具？
• 使用命令：mcp tools npx -y @modelcontextprotocol/server-filesystem ~
• 如何调用 MCP 服务器上的工具？
• 使用命令：mcp call read_file --params '{"path":"README.md"}' npx -y @modelcontextprotocol/server-filesystem ~

使用教程

使用依赖

• 安装 Homebrew（如果使用 Homebrew 安装）
• 安装 Go（如果从源代码安装）

安装教程

使用 Homebrew

brew tap f/mcptools
brew install mcp

从源代码安装

go install github.com/f/mcptools/cmd/mcptools@latest

调试方式

基本调试步骤

# 列出 MCP 服务器上的工具
mcp tools npx -y @modelcontextprotocol/server-filesystem ~

# 调用 MCP 服务器上的工具
mcp call read_file --params '{"path":"README.md"}' npx -y @modelcontextprotocol/server-filesystem ~

# 启动交互式 shell
mcp shell npx -y @modelcontextprotocol/server-filesystem ~

调试日志

# 查看模拟服务器日志
tail -f ~/.mcpt/logs/mock.log

# 查看代理服务器日志
tail -f ~/.mcpt/logs/proxy.log

# 实时查看所有日志（macOS/Linux）
find ~/.mcpt/logs -name "*.log" -exec tail -f {} \;

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。