mcpField
M
mcp-server-bash

mcp-server-bash

本地服务
github.com/antonum开发工具3382 周前更新
代码仓库

关于 mcp-server-bash

mcp-server-bash 是一个用 shell 脚本编写的极简 MCP 服务，演示了从初始化握手到工具调用的完整生命周期。它适合希望理解 MCP 协议底层消息格式的开发者。

主要功能

  1. 01使用 bash 脚本实现 MCP 服务
  2. 02覆盖初始化与运行两个阶段
  3. 03提供 tools/list 与 tools/call 消息处理
  4. 04内置一个加法工具 addition

适用场景

  1. 01学习 MCP 消息交互的基本结构
  2. 02通过命令行直接测试 JSON-RPC 请求与响应
  3. 03作为接入 LLM 宿主的最小示例

MCP 相关

该项目是一个 MCP 服务，通过 stdio 接收 JSON-RPC 消息，并向客户端暴露 addition 工具。配置文件中可将其加入 mcphost 或 Claude Desktop 等宿主。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-server-bash

用 Shell 脚本编写的极简 MCP 服务。

本仓库是这篇文章的补充：用 bash 脚本编写极简 MCP 服务

MCP 服务的生命周期可分为两个阶段：初始化和运行。

MCP 的阶段

mcp_add.sh 实现了此生命周期中的所有消息，从握手到执行简单的“两数相加”工具。

要直接在命令行中进行基本测试，请使用：

# test tools/list method
echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":2}' | bash mcp_add.sh | jq 

# test math_addition tool
echo '{"jsonrpc":"2.0","id":20, "method":"tools/call","params":{"name":"addition","arguments":{"num1":"1","num2":"2"}}}' | bash mcp_add.sh | jq

LLM 主机配置

mcphost 和 Claude Desktop 的 JSON 配置文件：

{
    "mcpServers": {
      "math": {
        "command": "/Users/anton/code/mcp-server-bash/mcp_add.sh",
        "args": []
      }
    }
  }

使用 mcphost 测试

为 bash 脚本添加执行权限：

chmod +x mcp_add.sh

使用 llama3.1 和工具配置文件运行 mcphost

mcphost -m ollama:llama3.1:latest --config /Users/anton/code/mcp-server-bash/mcp.json

...

using math tool add 10 and 88

参考资料

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。