pip install -e .

pip install -e ".[dev]"

# 通过命令行入口
cotton-mcp-tools

# 或直接运行
python -m cotton_mcp_tools.main

cotton-mcp-tools/
├── src/
│   └── cotton_mcp_tools/
│       ├── __init__.py          # 包初始化
│       ├── main.py              # MCP 服务入口
│       ├── tools/               # MCP 工具模块
│       │   ├── __init__.py      # 工具注册入口
│       │   └── sample.py        # 示例工具
│       └── utils/               # 工具函数
│           ├── __init__.py
│           └── config.py        # 配置管理
├── tests/                       # 测试文件
│   ├── __init__.py
│   └── test_sample.py           # 示例工具测试
├── pyproject.toml               # 项目配置与依赖
├── .gitignore
└── README.md

# src/cotton_mcp_tools/tools/my_tool.py
from mcp.server.fastmcp import FastMCP

def register_my_tools(server: FastMCP) -> None:
    @server.tool()
    def my_tool(param: str) -> str:
        """工具描述。

        Args:
            param: 参数说明

        Returns:
            返回值说明
        """
        return f"Result: {param}"

from cotton_mcp_tools.tools.my_tool import register_my_tools

def register_all_tools(server: FastMCP) -> None:
    register_sample_tools(server)
    register_my_tools(server)  # 添加这行

pytest

ruff check src/ tests/
ruff format src/ tests/