AI导哈

AI模型服务框架

一个基于FastAPI的AI模型服务框架，提供REST API和MCP协议支持，适用于容器化部署的AI模型服务场景。

  • by yudexlabs
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 yudexlabs/mcp-server-ideas

使用说明

FastAPI+MCP服务器YudexMinds

一个FASTAPI应用程序，它公开了REST API和MCP（模型上下文协议）服务器，在容器化的Docker环境中运行。

🚀 特点

  • API REST用于CRUD操作和业务逻辑的：Endpoints Fastapi
  • MCP 服务器：人工智能模型通信协议
  • Docker Compose：为开发和生产编排容器
  • 自动文档：Swagger UI和Redoc集成
  • 灵活配置：不同环境的环境变量

📋 先决条件

  • Docker>=20.10
  • Docker编写>=2.0
  • Python 3.11+（用于本地开发）

🛠️ 安装和配置

1.克隆存储库

git clone <[repository-url](https://github.com/yudexlabs/yudexminds-backend-mcp)>
cd mcp-server-ideas

2.配置环境变量

复制示例文件并根据您的环境调整变量：

cp .env.example .env

3.与Docker Compose一起执行

发展

docker-compose up --build

🏗️ 项目结构

├── app/
|   ├── auth_api.py          # Autenticación API
|   ├── auth_mcp.py          # Autenticación MCP
│   ├── config.py            # Configuración
│   └── main.py              # Punto de entrada FastAPI
|
|── nginx/
|   └── config               # Configuración Nginx
|
├── docker-compose.yml       # Docker Compose
├── Dockerfile
├── requirements.txt
├── claude_desktop_config.json
└── README.md

🔌 可用端点

API REST

API将在 http://localhost:8000

  • 文件大摇大摆: http://localhost:8000/docs
  • REDOC文件: http://localhost:8000/redoc

🐳 有用的Docker命令

# Ver logs en tiempo real
docker-compose logs -f

# Acceder al contenedor de la aplicación
docker-compose exec app bash

# Detener todos los servicios
docker-compose down

# Limpiar volúmenes y redes
docker-compose down -v --remove-orphans

# Reconstruir sin caché
docker-compose build --no-cache

🧪 测试

在本地运行测试

# Instalar dependencias
pip install -r requirements.txt
pip install -r requirements-dev.txt

# Ejecutar tests
pytest tests/

# Con coverage
pytest --cov=app tests/

📊 监测和记录

应用程序日志

# Ver logs de todos los servicios
docker-compose logs

# Ver logs de un servicio específico
docker-compose logs app

# Seguir logs en tiempo real
docker-compose logs -f app

相关 MCP