Easymcp

🚀 easyMcp

With just two steps, it helps developers quickly build an extensible MCP server framework, supporting both standard input/output and SSE startup modes.

🚀 Quick Start

📦 Step 1 [Optional] Define Required Configurations

Define the configurations required for the project in the src/config/.env file. For example, database configurations:

# MySQL database configuration
MYSQL_HOST=192.168.3.229
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=root
MYSQL_DATABASE=a_llm
MYSQL_ROLE=admin

💻 Step 2 Create Your Own Tools

Add your custom tool classes to the src/handles directory. Refer to the sample in example.py.

• Inherit from the BaseHandler class.
• Define the name attribute, representing the name of the tool.
• Define the description attribute, representing the description of the tool.
• Implement the get_tool_description method to tell the MCP client what your tool does.
• Implement the run_tool method, which is called by the MCP client to execute your tool's logic.
• Reference the new tool in __init__.py.

example.py

from typing import Dict, Any, Sequence

from mcp import Tool
from mcp.types import TextContent
from .base import BaseHandler
from config import get_config


class Example(BaseHandler):
    name = "get_Example"
    description = (
        "this is Example xxxx"
    )

    def get_tool_description(self) -> Tool:
        return Tool(
            name=self.name,
            description=self.description,
            inputSchema={
                "type": "object",
                "properties": {
                    "text": {
                        "type": "string",
                        "description": "This is the required text content"
                    }
                },
                "required": ["text"]
            }
        )

    async def run_tool(self, arguments: Dict[str, Any]) -> Sequence[TextContent]:

            try:
                if "text" not in arguments:
                    raise ValueError("Missing text content")

                text = arguments["text"]

                # Reference configuration information
                config = get_config()

                ## todo something

                result = "xxxxxxx"

                # Concatenate all results with commas
                return [TextContent(type="text", text=','.join(result))]

            except Exception as e:
                return [TextContent(type="text", text=f"Error: {str(e)}")]

__init__.py

from .example import Example


__all__ = [
    "Example",
]

▶️ Step 3 Start the Server

Currently, this framework supports two startup modes: standard input/output and SSE.

1. SSE Mode

• Start the service using uv. Add the following content to your MCP client tool, such as cursor, cline, etc.

The MCP JSON is as follows:

{
  "mcpServers": {
    "easyMcp": {
      "name": "easyMcp",
      "description": "",
      "isActive": true,
      "baseUrl": "http://localhost:9000/sse"
    }
  }
}

Startup commands:

# Download dependencies
uv sync

# Start the service
uv start

2. STDIO Mode

• Run the following command in the terminal to start the service:

python main.py

⚠️ Important Note

• Ensure that you have correctly installed all the necessary dependencies.
• When using the SSE mode, ensure that your network connection is stable.
• If you encounter any issues, check the log files for more information.