MCP-BOS

MCP-BOS

3.5

MCP-BOS is a modular and extensible Model Context Protocol server framework designed for Claude Desktop, enabling easy expansion of AI application functionalities without altering core code.

MCP-BOS is a flexible server framework for Model Context Protocol (MCP) that supports the FastMCP standard. It is designed with a modular architecture, allowing functionalities to be organized into self-contained modules for easy expansion. The framework employs a convention-based automatic module discovery mechanism, reducing the need for manual configuration. It features a declarative configuration system through a config.json file, enabling flexible module and parameter configuration. MCP-BOS is deeply integrated with Claude Desktop, providing an enhanced AI experience. The framework ensures security and stability through a layered architecture, separating core functionalities from business-specific modules. It also includes a comprehensive logging system for debugging and monitoring.

Features

  • {'name': 'Modular Design', 'description': 'Organizes functionalities into self-contained modules for easy expansion.'}
  • {'name': 'Automatic Discovery', 'description': 'Convention over configuration approach for module loading.'}
  • {'name': 'Declarative Configuration', 'description': 'Flexible configuration of modules and parameters via config.json.'}
  • {'name': 'Plug and Play', 'description': 'New functionalities can be added by simply including modules that conform to the interface.'}
  • {'name': 'Security and Stability', 'description': 'Layered architecture ensures the core system remains stable and reliable.'}

Usage with Different Platforms

Direct Run

bash
python main.py

UV Run

bash
uv run main.py

Claude Desktop Integration

bash
mcp install main.py

Development Debug Mode

bash
mcp inspect main.py

Frequently Asked Questions

Module not loading

Check if the module directory structure is correct, ensure init.py exports the module class, verify the module is enabled in the config file, and review log outputs for detailed error information.

Encoding issues

If encountering encoding issues on Windows, ensure the correct environment variable is set: PYTHONIOENCODING=utf-8.

Server connection issues

Ensure Claude Desktop is correctly configured, check if dependencies are properly installed, and review Claude Desktop log files.

Related MCP Servers

View all claude servers →