MCP-BOS
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 →mcp-unity
by CoderGamester
MCP Unity is an implementation of the Model Context Protocol for Unity Editor, allowing AI assistants to interact with your Unity projects.