git clone git@github.com:IYABAO/fastmcp-enterprise.git
cd fastmcp-enterprise
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -e ".[test]"

cp .env.example .env
# 按需修改 token、限流阈值等

python -m enterprise_mcp.server
# 默认 http://0.0.0.0:8080/mcp

from fastmcp import Client

async with Client("http://localhost:8080/mcp", auth="你的-token") as client:
    tools = await client.list_tools()          # 列出工具
    result = await client.call_tool("resume_search", {"query": {"keyword": "MCP", "min_years": 5}})

python -m enterprise_mcp.server --stdio

fastmcp-enterprise/
├── src/enterprise_mcp/
│   ├── server.py              # 入口：组装全部能力
│   ├── config/settings.py     # 配置管理（env / .env）
│   ├── auth/
│   │   ├── authenticator.py   # Token 校验 + 会话注册表
│   │   └── provider.py        # FastMCP AuthProvider 实现
│   ├── middleware/
│   │   ├── middleware.py      # 审计 / 脱敏 / 会话隔离 / 限流中间件
│   │   ├── desensitize.py     # PII 脱敏引擎
│   │   ├── audit.py           # 审计日志器
│   │   └── rate_limiter.py    # 滑动窗口限流器
│   └── tools/
│       └── demo_tools.py      # 示例业务工具（简历检索等）
├── deploy/
│   ├── docker/                # Dockerfile + docker-compose
│   └── k8s/                   # K8s Deployment + Service + Ingress
├── tests/                     # 单元 + 集成测试
├── examples/                  # 客户端示例
└── .github/workflows/ci.yml   # GitHub Actions

cd deploy/docker
docker compose up -d --build

kubectl apply -f deploy/k8s/deployment.yaml
# 生产环境建议：
# 1. Token 通过 Secret 注入（见 deployment.yaml 注释）
# 2. Redis 开启后支持多副本共享限流
# 3. 接入 Ingress + mTLS

# src/enterprise_mcp/tools/my_tools.py
from pydantic import BaseModel, Field
from fastmcp import FastMCP

def register_tools(mcp: FastMCP) -> None:
    @mcp.tool()
    async def your_tool(query: YourQuery) -> dict:
        """你的工具描述（LLM 会看到）。"""
        return {"result": "..."}

pytest tests/ -v
# 13 passed