Berry MCP Server
About
A universal framework for easily creating and deploying Model Context Protocol servers with any tools.
Details
- Author
- richinex
- Categories
- Developer Tools, API, Automation
Jump to
Setup
Install Berry MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/richinex/berry-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A universal framework for easily creating and deploying Model Context Protocol servers with any tools.
A universal Model Context Protocol (MCP) server framework that makes it easy to create and deploy custom tool servers for AI assistants like Claude.
- 🔧 Universal Framework: Create MCP servers for any type of tools
- 🎯 Simple Tool Creation: Decorator-based tool registration with automatic JSON schema generation
- 🔌 Plugin Architecture: Load tools from any Python module or package
- 🚀 Multiple Transports: Support for stdio and HTTP/SSE communication
- ⚙️ Flexible Configuration: Environment variables and command-line options
- 📝 Auto-Documentation: Automatic tool discovery and schema generation
- 🔒 Type Safety: Full type annotation support with validation
# Install from PyPI (when published) uv add berry-mcp # Or install from source git clone https://github.com/richinex/berry-mcp-server.git cd berry-mcp-server uv pip install -e .
# my_tools.py from berry_mcp.tools.decorators import tool @tool(description="Add two numbers together") def add_numbers(a: float, b: float) -> float: """Add two numbers and return the result""" return a + b @tool(description="Generate a greeting message") def greet(name: str, title: str = "friend") -> str: """Generate a personalized greeting""" return f"Hello {title} {name}!"
# Load your custom tools BERRY_MCP_TOOLS_PATH=my_tools uv run python -m berry_mcp # Or run with built-in example tools uv run python -m berry_mcp
{ "inputs": [], "servers": { "my-custom-tools": { "type": "stdio", "command": "uv", "args": ["run", "python", "-m", "berry_mcp"], "env": { "BERRY_MCP_TOOLS_PATH": "my_tools" } } } }
- VS Code Configuration Guide- Complete setup instructions
- Tool Development Guide- Create custom tools
- API Documentation- Technical reference
Berry MCP comes with example tools to get you started:
- Math Operations:add_numbers,generate_random
- Text Processing:format_text,find_replace_text,encode_decode_text
- System Info:get_system_info,generate_uuid
- Data Tools:validate_json,generate_report
- Async Examples:async_process_text
BERRY_MCP_TOOLS_PATH="my_tools,web_tools,data_processors" uv run python -m berry_mcp
uv run python -m berry_mcp --transport http --port 8080
export BERRY_MCP_SERVER_NAME="my-custom-server" export BERRY_MCP_LOG_LEVEL="DEBUG" export BERRY_MCP_TOOLS_PATH="my_tools,another_module.tools" uv run python -m berry_mcp
Berry MCP follows SOLID principles with a clean, extensible architecture:
- MCPServer: Core server orchestration
- ToolRegistry: Plugin-based tool management
- Transport Layer: Abstracted communication (stdio/HTTP)
- Protocol Handler: JSON-RPC message processing
- Tool Framework: Decorator-based tool creation
- Python 3.10+
- MCP protocol support
- Type annotations for automatic schema generation
- Fork the repository
- Create a feature branch:git checkout -b feature/amazing-feature
- Make your changes following the existing patterns
- Add tests for new functionality
- Run the test suite:pytest tests/
- Submit a pull request
MIT License - seeLICENSEfile for details.
🚀 Start building your custom MCP tools today with Berry MCP Server!
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
The MCP server for Bitrix24 provides AI assistants with structured access to the Bitrix24 API. It delivers up-to-date method descriptions, parameters, and valid values, allowing assistants to work with precise data instead of guesswork. This reduces code errors and accelerates Bitrix24 integration development.
One remote MCP server for 500+ production APIs — Stripe, HubSpot, Postgres, Gmail, and more. OAuth and API key auth, credential management, and a CLI.
Single tool to control all 100+ API integrations, and UI components
Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.
Self-hosted MCP gateway: convert REST/SOAP/GraphQL/SQL APIs into MCP tools with 29 pre-built adapters, OAuth2, RBAC and audit log.
A universal bridge to convert any web API into an MCP server, supporting multiple transport types.
Dynamically creates MCP servers from web API configurations, integrating any REST API, GraphQL endpoint, or web service into MCP-compatible tools.
Hosted MCP server and coordination layer for AI coding agents — live API contracts, database schema, frontend/backend mismatch detection, and shared handoff tickets for Claude Code, Cursor, Codex, and Lovable.
An MCP server that dynamically loads tools from an external JSON file configured via an environment variable.
A lightweight server exposing Axone's capabilities through the Model-Context Protocol.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
