中文文档

概要

エンタープライズレベルのモデルコンテキストプロトコル(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