mcp-server-bash

基本能力

产品定位

mcp-server-bash 是一个用 shell 脚本编写的极简 MCP 服务器，主要用于执行简单的工具调用，如加法运算，并支持与 LLM 主机配置集成。

核心功能

• 实现 MCP 服务器的生命周期，包括初始化和操作两个阶段。
• 支持 tools/list 方法，用于列出可用工具。
• 支持 tools/call 方法，用于调用特定工具（如加法运算）。
• 可以与 LLM 主机（如 mcphost）集成，通过配置文件指定 MCP 服务器的命令和参数。

适用场景

• 开发者在 CLI 环境中测试 MCP 服务器的功能。
• 与 LLM 主机（如 mcphost）集成，扩展 LLM 的工具调用能力。
• 学习和理解 MCP 协议的基本实现。

工具列表

• addition：加法工具，用于计算两个数字的和。

常见问题解答

• 如何测试工具列表？ bash echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":2}' | bash mcp_add.sh | jq
• 如何测试加法工具？ bash echo '{"jsonrpc":"2.0","id":20, "method":"tools/call","params":{"name":"addition","arguments":{"num1":"1","num2":"2"}}}' | bash mcp_add.sh | jq

使用教程

使用依赖

• 需要安装 jq 工具用于 JSON 解析。
• 需要安装 mcphost（可选，用于与 LLM 集成）。

安装教程

1. 克隆仓库或下载 mcp_add.sh 脚本。
2. 为脚本添加执行权限： bash chmod +x mcp_add.sh

调试方式

1. 测试工具列表： bash echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":2}' | bash mcp_add.sh | jq
2. 测试加法工具： bash echo '{"jsonrpc":"2.0","id":20, "method":"tools/call","params":{"name":"addition","arguments":{"num1":"1","num2":"2"}}}' | bash mcp_add.sh | jq
3. 与 mcphost 集成： bash mcphost -m ollama:llama3.1:latest --config /path/to/mcp.json

许可证

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