mcp-server-bash-sdk

纯 Bash 写 MCP 服务器,零依赖跑通 AI 工具调用

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 51 🐛 待处理 7 👀 关注 4
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 515
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,无付费版本。

项目预览

mcp-server-bash-sdk 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队muthuishere
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Shell
技术栈/模型ai-agents,bash,mcp,model-context-protocol,sdk
GitHub 星标★ 515
上线时间2025-05-29 00:00:00
代码更新2026-09-09
仓库体积197 KB
本站数据更新2026-11-09
维护状态维护中
收录时间2026-08-09
浏览次数8

项目介绍

mcp-server-bash-sdk 是一个完全用 Bash 实现的 MCP(Model Context Protocol)服务器 SDK 和示例。它解决了在资源受限或无法安装 Node.js、Python 等运行时环境中构建 MCP 服务器的痛点,让开发者仅依赖 POSIX shell 即可快速搭建与 AI 代理交互的工具。项目提供了一套简洁的 Bash 函数库,封装了 MCP 协议的初始化、消息收发和工具注册等核心流程,并附带完整示例,展示如何通过标准输入输出与客户端通信。其核心能力包括:轻量无依赖、易于嵌入现有脚本、支持自定义工具定义和调用。适合快速原型验证、边缘设备集成或作为学习 MCP 协议的参考实现。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 515

使用教程

难度:进阶 约 30 分钟 部署方式:本地安装 5 步

环境要求

  • Bash 4+
  • curl

安装与启动步骤

  1. 1拉仓库

    它是一套纯 Shell 的 MCP 实现,几乎零依赖。

    git clone https://github.com/muthuishere/mcp-server-bash-sdk
  2. 2跑内置测试

    自带三十多条单元测试,先跑一遍。

    ./test_mcpserver_core.sh
  3. 3跑一致性测试

    对着官方 schema 校验,这一步最关键。

    ./test_conformance.sh
  4. 4起服务

    标准输入输出与 HTTP 两种传输都支持。

    ./moviemcpserver.sh
  5. 5改成你的服务

    把示例里的工具换掉,脚本结构照用。

如何确认成功

起服务后用一个 MCP 客户端连上,能正确列出工具并调用成功,一致性测试全部通过

注意事项

  • 它用纯 Bash 实现 MCP 服务端,零运行时依赖,适合极小环境。
  • 自带一致性测试是它可信度高的原因,很多实现没有这一步。
  • 跨发行版测试脚本已给,部署前跑一遍。
  • 复杂逻辑用 Shell 写维护成本高,适合薄封装。

核心亮点

  • 零运行时依赖,只需 POSIX shell,可在极简环境或容器中直接运行
  • 代码简洁,Bash 函数封装协议细节,上手门槛低,适合快速原型
  • 自带完整示例,清晰展示工具注册与调用流程,便于学习 MCP 协议

不足之处

  • Bash 处理复杂 JSON 和并发能力弱,不适合高复杂度或高并发场景
  • 文档/社区待观察

适用场景

  • 在无 Python/Node 的嵌入式设备或精简容器中提供 MCP 工具服务
  • 快速验证 MCP 协议交互,作为教学或协议调试工具
  • 将现有 Bash 脚本封装为 AI 可调用的工具,无需重写语言

替代项目

mcp-python-sdk、mcp-typescript-sdk、mcp-server-fetch

上一篇:django-orm-lens

下一篇:youtu-agent

同类项目推荐

air 开源

让 AI 一次写对 Python Web 应用,少写 JS 多出活

The first web framework designed for AI to write. Built on Python, FastAPI, Pydantic···

★ 920 2026-10-08
CodeFuse-muAgent 开源

给Agent装上知识图谱大脑,让复杂任务推理更准更可信

An Innovative Agent Framework Driven by KG Engine

★ 777 2026-08-09
CopilotKit 开源

App 里塞进智能助手,用户动嘴就能使唤

The Frontend Stack for Agents & Generative UI. React, Angular, Mobile, Slack, and mo···

★ 38576 2026-08-09
Gen.jl 开源

用 Julia 写模型和推断算法的概率编程框架

A general-purpose probabilistic programming system with programmable inference

★ 1855 2026-11-07
loop-engineering 开源

套上现成模板,AI 干活一次比一次稳。

Practical patterns, starters & CLI tools for loop engineering with AI coding agents.···

★ 11734 2026-08-09
voltagent 开源

用 TypeScript 快速构建可观测、可扩展的 AI 智能体应用。

AI Agent Engineering Platform built on an Open Source TypeScript AI Agent Framework

★ 10934 2026-08-09
langcorn 开源

把 LangChain 应用一键变成 API 服务,快速上线

⛓️ Serving LangChain LLM apps and agents automagically with FastApi. LLMops

★ 940 2026-08-09
open-autonomy 开源

用Python快速搭建可部署的去中心化自主智能体服务

A framework for the creation of autonomous agent services.

★ 137 2026-08-09