使用说明

� 狗MCP服务器-快速MCP版

简单有趣的MCP服务器 FastMCP 让克劳德像狗一样吠叫，做神奇的手术。非常适合寻求快速和简单的初创公司！

特征

🐶 狗吠 不同强度的
🪄 神奇行动 （任何数字加15）
⚡ FastMCP -简化配置
🐳 Docker就绪 -集装箱化并准备生产
📝 日志记录完成 对位调试

🏗️ Arquitectura

Claude Desktop ──stdio──► FastMCP Server ──Docker──► Production

FastMCP：MCP框架简化
工具：Decoradores @mcp.tool() 汽车
运输：自动STDIO（无手动设置）

⚡ 快速安装

地方发展

# 1. Instalar dependencias
pip install mcp

# 2. Ejecutar servidor
python enterprise_mcp_server.py

# 3. Configurar Claude Desktop
# Copia el JSON de configuración a tu Claude Desktop

带Docker（推荐用于生产）

# 1. Usar script automatizado (Recomendado)
chmod +x build_docker.sh
./build_docker.sh

# 2. O manualmente
docker build -t dog-mcp-server .
docker run --rm dog-mcp-server

# 3. Con docker-compose
docker-compose up -d

🎯 可用的工具

� `bark_like_dog`

它使服务器像狗一样吠叫，强度不同。

参数：

intensity （string）：“软”、“正常”、“大声”

示例：

intensity: "soft" → “汪汪”🐕"
intensity: "normal" → “汪汪！汪汪！🐶"
intensity: "loud" → “呜呜呜！🐕‍🦺 吠叫！"

🪄 `magic_tool`

以“神奇”的方式将15添加到任何数字中。

参数：

number （浮动）：将添加到15的数字

示例：

number: 25 神奇的结果：25 + 15 = 40✨ ”

Claude 桌面设置

将此设置添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "dog-server": {
      "command": "python",
      "args": ["/ruta/absoluta/a/enterprise_mcp_server.py"],
      "env": {
        "PYTHONPATH": "/ruta/absoluta/a/tu/proyecto"
      }
    }
  }
}

📁 项目结构

mcp-server-demo/
├── enterprise_mcp_server.py    # 🐕 Servidor principal (FastMCP)
├── old-enterprise_mcp_server.py # 📜 Versión anterior (manual)
├── build_docker.sh             # 🐳 Script de construcción Docker
├── Dockerfile                   # 🐳 Configuración Docker
├── docker-compose.yml          # 🚀 Docker Compose
├── pyproject.toml              # 📦 Configuración del proyecto
├── uv.lock                     # 🔒 Lock de dependencias
├── claude_desktop_config.json  # ⚙️ Configuración Claude
└── README.md                   # 📖 Esta documentación

💻 发展

Código FastMCP（实际）

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("dog-server")

@mcp.tool()
async def bark_like_dog(intensity: str = "normal") -> str:
    """Ladra como un perro"""
    if intensity == "soft":
        return "woof woof 🐕"
    elif intensity == "loud":
        return "WOOF WOOF WOOF! 🐕‍🦺"
    else:
        return "Woof! Woof! 🐶"

if __name__ == "__main__":
    mcp.run()

FASTMCP的优势

✅ 50% 减少代码 什么手动设置
✅ 简单的装饰 @mcp.tool()
✅ 自动处理 运输和示意图
✅ 类型提示automáticos 用于验证
✅ Perfecto para初创公司 -快速发展

🛠️ 脚本消耗品

� 构建Docker（自动化）

# Script principal para Docker
chmod +x build_docker.sh
./build_docker.sh

El脚本 build_docker.sh 它：

✅ 自动构建Docker图像
✅ 带有Y版的塔加 latest
✅ 运行图像的基本测试
✅ 显示创建的图像信息
✅ 推到注册表的选项

🚀 部署y测试

# Crear script de despliegue personalizado
chmod +x deploy.sh && ./deploy.sh

# Test local directo
python enterprise_mcp_server.py

🐳 Docker命令

# Usar script automatizado (Recomendado)
./build_docker.sh

# Desarrollo con compose
docker-compose up -d

# Producción directa
docker run --rm dog-mcp-server

# Ver logs
docker logs dog-mcp-server

# Rebuild completo
./build_docker.sh --clean

🆘 故障排除

常见问题

问题	解决方案
`ModuleNotFoundError: No module named 'mcp'`	`pip install mcp`
Claude没有连接	验证配置中的绝对路径
Docker 无法启动 `docker-compose logs`
繁忙的端口	在docker-compose.yml中更改端口

调试模式

# Logs detallados
export LOG_LEVEL=DEBUG
python enterprise_mcp_server.py

# O en Docker
docker run -e LOG_LEVEL=DEBUG dog-mcp-server

📚 回顾

MCP文件 -社会文件
FastMCP指南 -Guía FastMCP
Claude桌面设置 Claude 设置

🎉 MCP服务器已准备好启动！

用…建造❤️ 使用FastMCP-创建MCP服务器的最快方法