中文文档

개요

기업용 모델 컨텍스트 프로토콜(MCP) 도구 개발을 위해 설계된 전문 프레임워크로, MCP 서버 개발 프로세스를 표준화하여 개발자들이 고품질 AI 도구를 빠르게 구축할 수 있도록 돕습니다. FastAPI와 FastAPI-MCP를 통합함으로써 이 프레임워크는 전통적인 API에서 AI 호출 가능한 도구로의 원활한 전환을 가능하게 합니다.

주요 특징

• MCP 도구 표준화: 전통적인 FastAPI 엔드포인트를 AI 모델 호출 가능한 MCP 도구로 자동 변환
• 인터페이스-구현 분리: 인터페이스 정의와 구현 간의 명확한 분리를 지원하여 테스트 및 환경 전환을 용이하게 합니다
• 의존성 주입 설계: FastAPI의 의존성 주입 메커니즘을 활용해 유연한 구성 요소 구성과 분리
• 완성된 개발 파이프라인: 개발부터 테스트, 배포까지 포괄적인 툴체인 지원
• 예제 기반 문서화: 실용적인 사례를 통해 모범 사례를 보여주어 온보딩을 가속화합니다

이 프레임워크는 특히 다음 분야에 적합합니다:

• AI 도구 개발 팀
• 기존 API를 AI 도구로 전환하려는 개발자

MCP Server Development Framework

中文文档

Overview

A professional framework designed for enterprise-level Model Context Protocol (MCP) tool development, standardizing the MCP server development process to help developers rapidly build high-quality AI tools. By integrating FastAPI with FastAPI-MCP, this framework enables seamless transformation from traditional APIs to AI-callable tools.

Key Features

• MCP Tool Standardization: Automatically convert traditional FastAPI endpoints into AI model-callable MCP tools
• Interface-Implementation Separation: Support clear separation between interface definitions and implementations, facilitating testing and environment switching
• Dependency Injection Design: Leverage FastAPI’s dependency injection mechanism for flexible component composition and decoupling
• Complete Development Pipeline: Provide comprehensive toolchain support from development to testing and deployment
• Example-Driven Documentation: Demonstrate best practices through practical examples to accelerate onboarding

This framework is particularly suitable for:

• AI tool development teams
• Developers looking to transform existing APIs into AI tools
• Organizations implementing standardized microservice architectures

Architecture

Core Architecture

┌─────────────┐      ┌───────────────┐      ┌─────────────────┐
│   API Layer │ ──→  │ Service Layer │ ──→  │ Implementation  │
└─────────────┘      └───────────────┘      └─────────────────┘
       ↓
┌─────────────┐
│ MCP Endpoint│ ←── FastAPI-MCP Auto-Conversion
└─────────────┘

Key Components

• FastAPI Application: Provides the HTTP API service foundation
• FastAPI-MCP: Converts API endpoints to MCP tools
• Service Interface Layer: Defines service contracts through abstract base classes
• Dependency Injection Providers: Manages service instance creation and injection
• Implementation Classes: Includes Mock and Real implementations with environment-based switching

Technology Stack

• Python 3.10+: Utilizing latest language features and type annotations
• FastAPI: High-performance asynchronous web framework
• FastAPI-MCP: Automatically exposes FastAPI endpoints as MCP tools
• Development Toolchain: Includes code quality checking and testing tools

Quick Start

Environment Setup

This framework uses uv as its package manager, providing faster dependency resolution and virtual environment management. For installation instructions, see the uv official documentation.

# Install dependencies and set up the development environment
make install

Launch Example Service

# Start the development server
make dev

Once the service is running, you can:

• Access the API documentation at http://localhost:5000/docs