MCP Bos

MCP开发工具

提供方 gooboot

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

MCP-BOS: 模块化、可扩展的Model Context Protocol服务器框架 使用基于约定的自动模块发现机制,为Claude Desktop打造的灵活MCP服务器框架。通过简洁的模块接口和声明式配置,轻松扩展AI应用功能,无需修改核心代码。支持FastMCP标准,包含完整工具、资源和提示模板注册能力。

一句话选型结论

按资料字段整理

MCP Bos 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

developer-toolsmcppython3claudemcp-servermcp-clientfastmcp模块化设计

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python main.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Bos当前 未标注 stdio · 本地进程 本地部署 有 2026-05-18
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方gooboot上游标注的维护方 gooboot
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-18上游最后核验时间

详细介绍

6.5 KB
来自项目仓库与上游目录的原文,未做删改

MCP-BOS: 可扩展的MCP服务器框架

MCP-BOS: 模块化、可扩展的Model Context Protocol服务器框架

使用基于约定的自动模块发现机制,为Claude Desktop打造的灵活MCP服务器框架。通过简洁的模块接口和声明式配置,轻松扩展AI应用功能,无需修改核心代码。支持FastMCP标准,包含完整工具、资源和提示模板注册能力。

特性

  • 🧩 模块化设计:功能以自包含模块组织,便于扩展
  • 🔍 自动发现:约定优于配置的模块加载方式
  • ⚙️ 声明式配置:通过config.json灵活配置模块和参数
  • 🔌 即插即用:新功能只需添加符合接口的模块目录
  • 🔒 安全稳定:分层架构确保核心系统稳定可靠
  • 📝 详细日志:完善的日志系统便于调试与监控
  • 🖥️ Claude Desktop集成:与Claude深度集成,提供AI增强体验

技术栈

Python FastMCP Model Context Protocol Claude Desktop JSON 模块化设计 微内核架构

架构思想

MCP-BOS框架采用了现代化的模块化架构设计,主要设计理念包括:

模块化设计

整个框架以模块为中心,每个功能都被封装在独立的模块中,使功能扩展变得简单直观。模块之间相互独立,但又通过标准接口相互协作,形成一个完整的服务生态。

自动发现机制

框架能够自动发现modules目录下的模块,无需手动注册每个模块。这种"约定优于配置"的方式大幅降低了扩展成本。

声明式配置

通过config.json文件进行全局和模块级别的配置,使框架具有很高的灵活性,可以根据不同需求启用或禁用特定模块。

分层架构

框架分为核心层和模块层,核心层负责框架基础功能,模块层负责具体业务功能,这种分层设计使框架更加健壮和可维护。

目录结构说明```

mcp-bos/
├── config.json # 全局配置文件
├── main.py # 主入口文件
├── core/ # 核心系统
│ ├── init.py
│ ├── module_registry.py # 模块注册表
│ ├── module_loader.py # 模块加载器
│ ├── module_interface.py # 模块接口定义
│ ├── config_manager.py # 配置管理器
│ └── server.py # FastMCP服务器适配
├── modules/ # 功能模块目录
│ ├── init.py
│ ├── hello_world/ # Hello World示例模块
│ │ ├── init.py
│ │ └── hello.py
│ └── ... # 其他功能模块
├── utils/ # 工具函数
│ ├── init.py
│ └── helpers.py
└── README.md # 项目文档


### 核心组件说明

- **main.py**: 框架入口点,负责初始化和启动服务器
- **core/**: 核心组件目录
- **module_interface.py**: 定义所有模块必须实现的接口
- **module_registry.py**: 管理已注册的模块
- **module_loader.py**: 自动发现和加载模块
- **config_manager.py**: 加载和管理配置
- **server.py**: 与FastMCP集成,提供服务器功能
- **modules/**: 功能模块目录,每个子目录是一个独立模块
- **utils/**: 通用工具函数

## 配置文件结构

`config.json`文件是框架的核心配置,分为全局配置和模块配置两部分:```json
{
"global": {
"server_name": "MCP-BOS",
"debug": true,
"log_level": "INFO",
"transport": "stdio",
"dependencies": ["mcp[cli]"]
},
"modules": {
"hello_world": {
"enabled": true,
"message": "Hello, {}!"
},
"module_name": {
"enabled": false,
"param1": "value1"
}
}
}
  • global: 全局配置部分
  • server_name: 服务器名称
  • debug: 是否启用调试模式
  • log_level: 日志级别
  • transport: 传输协议,通常为"stdio"
  • dependencies: 依赖包列表

  • modules: 模块配置部分,每个模块有自己的配置节

  • enabled: 是否启用该模块
  • 其他模块特定的配置参数

使用方法

安装

  1. 克隆仓库:```bash
    git clone https://github.com/kinbos/mcp-bos.git
    cd mcp-bos

2. 安装依赖:```bash
uv pip install mcp[cli]

配置

编辑config.json文件来配置服务器和模块:

  1. 设置服务器名称、日志级别等全局参数
  2. 启用或禁用模块
  3. 配置模块特定参数

运行

有以下几种方式运行服务器:

  1. 直接运行:```bash
    python main.py

2. **使用uv运行**:```bash
uv run main.py
  1. 与Claude Desktop集成:```bash

使用mcp CLI集成到Claude Desktop

mcp install main.py


4. **开发调试模式**:```bash
# 使用mcp Inspector测试服务器
mcp inspect main.py

添加新模块

  1. 在modules目录下创建一个新的模块目录:```bash
    mkdir modules/my_module

2. 创建必要的文件:```bash
touch modules/my_module/__init__.py
touch modules/my_module/my_module.py
  1. 实现模块接口:```python

modules/my_module/my_module.py

from core.module_interface import ModuleInterface

class MyModule(ModuleInterface):
def get_info(self):
return {
"name": "my_module",
"version": "1.0.0",
"description": "我的自定义模块",
"author": "kinbos 严富坤",
"email": "fookinbos@gmail.com",
"website": "htttps://www.yanfukun.com"
}

def register(self, server):
@server.tool()
def my_tool(param: str) -> str:
"""自定义工具"""
return f"处理参数: {param}"

@server.resource("my://resource")
def my_resource() -> str:
"""自定义资源"""
return "资源内容"


4. 导出模块类:```python
# modules/my_module/__init__.py
from modules.my_module.my_module import MyModule

__all__ = ['MyModule']
  1. 在配置文件中启用模块:```json
    {
    "modules": {
    "my_module": {
    "enabled": true,
    "custom_param": "value"
    }
    }
    }

6. 重启服务器,新模块将被自动发现和加载

## 常见问题

### 模块未加载
- 检查模块目录结构是否正确
- 确认`__init__.py`文件是否导出了模块类
- 检查配置文件中模块是否启用
- 查看日志输出,了解详细错误信息

### 编码问题
如果在Windows环境下遇到中文编码问题,确保设置了正确的环境变量:```json
"env": {
"PYTHONIOENCODING": "utf-8"
}

服务器连接问题

  • 确认Claude Desktop已正确配置
  • 检查依赖是否正确安装
  • 查看Claude Desktop日志文件

贡献指南

欢迎提交贡献,请遵循以下步骤:
1. Fork项目
2. 创建功能分支
3. 提交更改
4. 创建Pull Request

作者

  • kinbos 严富坤 - 个人网站
  • 邮箱: fookinbos@gmail.com

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Bos 怎么安装?

在客户端按下面的安装命令接入:python main.py。装完在客户端配置里引用同一个包或端点。

MCP Bos 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Bos 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Bos 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Bos 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Bos 能提供哪些能力?

资料显示能力标签包括 模块化设计、服务器框架、Python、Claude。具体工具清单以官方文档为准。

MCP Bos 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

MCP Bos 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-18。