MCP服务器脚手架工具

mcpcli

一个CLI工具，用于在Go和其他语言中构建模型上下文协议（MCP）服务器项目。它生成支持多种传输、Docker和示例资源/工具的即用型MCP服务器模板。

当前版本： v0.4.1（最新版本）

有关模型上下文协议的更多信息，请访问 官方介绍页.

特性

• 使用单个命令生成新的MCP服务器项目
• 支持多种语言（Go、Node.js、Java、Python）
• 选择传输方式（stdio、rest、websocket）
• 可选Docker支持
• 示例资源和工具
• 交互式和非交互式模式
• 测试MCP服务器资源、工具和功能

安装

克隆存储库并构建CLI：

git clone https://github.com/aawadall/mcpcli.git
cd mcpcli
go build -o mcpcli ./cmd/mcpcli

可用命令

• generate （别名： gen, g)：生成新的MCP服务器项目
• test：测试MCP服务器资源、工具、功能和初始化

用法

生成新的MCP服务器项目

./mcpcli generate my-server --language golang --transport stdio --docker --examples

或者使用交互模式（如果缺少必需的选项）：

./mcpcli generate

生成标志

• --name, -n 项目名称
• --language, -l 程序设计语言(golang, python, java, javascript/Node.js）
• --transport, -t 运输方式(stdio, rest, websocket)
• --docker, -d 包括Docker支持
• --examples, -e 包括示例资源和工具
• --output, -o 输出目录（默认：项目名称）
• --force, -f 覆盖现有目录

测试MCP服务器

./mcpcli test --config configs/mcp-config.json --all

或者使用交互模式（如果没有提供标志）：

./mcpcli test

测试标志

• --config, -c MCP配置文件的路径
• --all 测试所有组件（资源、工具、功能、初始化）
• --resources 测试资源
• --tools 测试工具
• --capabilities 测试能力
• --init 测试初始化
• --script, -f 测试脚本文件的路径

全球旗帜

• --verbose, -v 启用详细输出
• --quiet, -q 抑制输出

项目结构

• cmd/ CLI的入口点
• internal/ 核心逻辑、生成器、处理程序、模板
• pkg/ 共享包

生成的项目示例

生成的Go MCP服务器项目包括：

• cmd/server/main.go -主服务器入口点
• internal/handlers/ -请求处理程序
• pkg/mcp/ -MCP协议类型和客户端
• configs/mcp-config.json -服务器配置
• Dockerfile -Docker支持（可选）
• examples/ -示例用法（可选）

生成的Node.js MCP服务器项目包括：

• src/index.js -主服务器入口点
• src/handlers/ -请求处理程序
• configs/mcp-config.json -服务器配置
• Dockerfile -Docker支持（可选）

测试

跑 go test ./... -cover 执行单元测试。总体覆盖率应保持在85%以上。 最近增加的内容包括以下测试 internal/commands/test.go 以及错误处理案例 internal/generators/node_test.go 以确保CLI测试工作流按预期运行。 看 测试指南 有关运行以下测试的更多详细信息 mcpcli v0.4.1（最新）. 所有捐款必须保持这一最低覆盖水平。

贡献

欢迎投稿！请打开问题或拉取请求。

释放

这 发布工作流程 构建跨平台档案。 有关包装的详细信息 mcpcli 关于Homebrew、APT和巧克力，请参阅 发布指南.

许可证

MIT许可证

进一步阅读

• 模型上下文协议介绍