MCP 服务器

easyMcp

That's a good translation! It's accurate and concise. Here are a couple of minor variations that might be slightly more natural, depending on the specific context: * **使开发者能够快速构建一个支持stdio和sse的MCP服务器服务框架。** (This emphasizes the *ability* of the developers.) * **帮助开发者快速构建一个支持stdio和sse的MCP服务器服务框架。** (This emphasizes the *assistance* provided in building the framework.) The original translation is perfectly understandable, but these alternatives might flow a bit better in some situations. The key difference is the choice of verb: * **使 (shǐ):** To cause, to enable, to make * **使能够 (shǐ nénggòu):** To enable (more explicitly) * **帮助 (bāngzhù):** To help, to assist Ultimately, the best choice depends on the nuance you want to convey.

wenb1n-dev

开发者工具

访问服务器

README

easyMcp

只需两步即可帮助开发者快速构建可扩展的 mcp 服务器框架，该框架支持 stdio 和 SSE 两种启动模式。

用户手册

1. 第一步 [可选] 定义所需配置

在 src/config/.env 中定义项目所需的配置，例如数据库配置：

 # MySQL 数据库配置
MYSQL_HOST=192.168.3.229
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=root
MYSQL_DATABASE=a_llm
MYSQL_ROLE=admin

2. 第二步创建您自己的工具

在 src/handles 目录中添加您自己的工具类，参考 example.py 示例

继承自 BaseHandler
定义 name 属性，这是工具的名称
定义 description 属性，这是工具的描述
实现 get_tool_description 方法，该方法告诉 mcp 客户端您的工具的作用
实现 run_tool 方法，该方法由 mcp 客户端调用以执行您的工具逻辑
在 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 text that must be entered for the example"
                    }
                },
                "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"

                # Join 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",
]

3. 启动

目前，该框架支持两种启动模式：stdio 和 SSE。

1. SSE 模式

使用 uv 启动服务

将以下内容添加到您的 mcp 客户端工具中，例如 cursor、cline 等。

mcp json 如下

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

启动命令

# 下载依赖
uv sync

# 启动
uv run server.py

2. STDIO 模式

将以下内容添加到您的 mcp 客户端工具中，例如 cursor、cline 等。

mcp json 如下

{
  "mcpServers": {
      "easyMcp": {
        "isActive": true,
        "name": "easyMcp",
        "command": "uv",
        "args": [
          "--directory",
          "G:\\python\\mysql_mcp\\src",  # 替换为您的项目路径
          "run",
          "server.py",
          "--stdio"
        ],
        "env": {
          "MYSQL_HOST": "192.168.xxx.xxx",
          "MYSQL_PORT": "3306",
          "MYSQL_USER": "root",
          "MYSQL_PASSWORD": "root",
          "MYSQL_DATABASE": "a_llm",
          "MYSQL_ROLE": "admin"
       }
    }
  }
}    

## 效果图
![image](https://github.com/user-attachments/assets/72854681-16ad-4dc8-a095-5e6e63e07deb)