현대 API 키 인증, 사용자 관리 및 동적 도구 공유를 가진 Model Context Protocol (MCP) 서버 구축을위한 유연한 확장 가능한 프레임 워크.

---

🚀 개요

동적인 MCP 서버는 보안, 사용자 인식 및 확장 가능한 AI 도구 서버를 가능하게 합니다. 그것은 지원합니다:

• API 키 기반 인증 (모든 MCP 클라이언트와 호환)
• 사용자 관리 및 권한 (MongoDB 백업)
• **Session 기반, per-user 도구 로딩 **
• 도구 공유 및 편두통 접근 제한
• ** 다운스트림 프로젝트에 대한 탁월한 HTTP 및 데이터베이스 레이어 **

---

! 키 기능

• Dynamic Tool Management: runtime-tools에서 도구 생성, 삭제 및 승인은 시작 또는 코드에서 정적 정의에 제한되지 않습니다. 이 진정한 실행 시간 확장을 가능하게하고 다른 MCP 서버에서 1 차적인 차별화입니다.
• 사용자 관리: 추가, 업데이트, 삭제 및 목록 사용자; 관리자 bootstrapping; 역할 기반 액세스. -Tool 공유: 다른 사용자와 공유 도구, 액세스 레벨을 관리하고 실시간 업데이트를 받으십시오.
• **현대 오 **: 단순한 API 키 인증, 권한 부여를 위한 MongoDB.

Dynamic MCP Server Framework

A flexible, extensible framework for building Model Context Protocol (MCP) servers with modern API key authentication, user management, and dynamic tool sharing.

---

🚀 Overview

Dynamic MCP Server enables secure, user-aware, and extensible AI tool servers. It supports:

• API key-based authentication (simple, compatible with all MCP clients)
• User management and authorization (MongoDB-backed)
• Session-based, per-user tool loading
• Tool sharing and fine-grained access control
• Extensible HTTP and database layers for downstream projects

---

🌟 Key Features

• Dynamic Tool Management: Create, delete, and authorize tools at runtime—tools are not limited to static definitions at startup or in code. This enables true runtime extensibility and is a primary differentiator from most other MCP servers.
• User Management: Add, update, delete, and list users; admin bootstrapping; role-based access.
• Tool Sharing: Share tools with other users, manage access levels, and receive real-time updates.
• Modern Auth: Simple API key authentication, MongoDB for authorization.
• Extensibility: Add custom HTTP routes and MongoDB collections in downstream projects.
• Session-based Tool Loading: Tools are loaded per user session, not globally.

---

🔑 Authentication (API Key)

• Each user is assigned a unique apiKey (generated automatically on user creation).
• To authenticate, clients must provide the apiKey via query parameter OR header:
  • Query Parameter: ?apiKey=your-key or ?apikey=your-key
  • Header: x-apikey: your-key or apikey: your-key
• Streamable HTTP Transport (Modern): /mcp?apiKey=... or /mcp with header
• The server authenticates the user by looking up the apiKey in the database.

---

🚀 Transport Protocols

Dynamic MCP Server supports both legacy and modern MCP transport protocols:

Streamable HTTP Transport

• Protocol Version: 2025-03-26
• Endpoint: /mcp
• Features: Modern, efficient, single-endpoint design
• Authentication: Query parameter ?apiKey=your-key OR header x-apikey: your-key
• Usage: Recommended for new integrations

---

� Documentation

• Getting Started
• Transport Protocols
• User Management
• Tool Management & Sharing
• Authentication & Authorization
• Extending the Server (HTTP & DB)
• API Reference
• Examples
• Extending the Server: Creating Handler & Tool Packages
• Test Patterns & Mocking Strategies

Tool Visibility Model: