🏭 MCP工厂

完成MCP开发基础 -用于模型上下文协议开发的生产就绪服务器、模板和工具

![Python](https://python.org) ![MCP](https://modelcontextprotocol.io) ![FastMCP](#) ![Two-Way](#) ![License](LICENSE)

🎯 什么是MCP工厂？

MCP工厂 是MCP开发最全面的基础，具有生产就绪的服务器、双向通信、真正的LLM采样以及构建高级AI集成所需的一切。

graph LR
    A[🎯 Basic MCP] --> B[🚀 FastMCP 2.0]
    B --> C[🔄 Two-Way Communication] 
    C --> D[🌟 Knowledge Assistant]
    D --> E[🏭 Production Ready]
    
    style E fill:#e8f5e8,stroke:#4caf50,stroke-width:2px

🌟 高亮：我们的 知识助理 服务器展示 45 MCP功能 包括真正的LLM采样、双向通信和外部API集成。

______________________________________________________________________

🚀 快速开始

⚡ 试用知识助手（推荐）

# 1. Clone and setup
git clone https://github.com/your-username/mcpFactory.git
cd mcpFactory

# 2. Install UV (modern Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 3. Run the Knowledge Assistant server
cd src/servers/knowledge_assistant
uv sync
uv run python server.py

# 4. Launch Inspector (new terminal)
cd ../../..
./scripts/start-inspector.sh

🎉 结果：Chrome会自动打开，MCP检查器连接到具有以下功能的服务器 45种能力!

🧪 测试功率

连接：检查器自动连接到 http://127.0.0.1:8080/mcp/
探索：运行 get_server_info() 查看全部45个功能
尝试双向：执行 ask_question() -服务器会问你问题！
真正的法学硕士：测试 generate_summary() - 使用当前LLM通过 ctx.sample()

______________________________________________________________________

📊 里面是什么？

🌟 知识助理 -皇冠上的宝石

🧠 Knowledge Assistant (45 MCP Capabilities)
├── 🛠️  17 Tools      → CRUD, management, analysis  
├── 📁  7 Resources   → URI-based data access
├── 💬  6 Prompts     → LLM templates
├── 🎲  6 Sampling    → Real LLM via ctx.sample()
├── 🔄  3 Interactive → Two-way communication
└── 🌐  5 External    → Wikipedia, ArXiv, news APIs

🏗️ 完成服务器收集

服务器	用途	复杂性	功能
`hello_world`	MCP基本示例	⭐ 简单	工具、资源
`ping_pong`	沟通模式	⭐⭐ 中等	纯MCP与快速MCP
`two_way`	双向聊天	⭐⭐⭐ 高级	互动调查
`knowledge_assistant`	完整展示	⭐⭐⭐⭐⭐ 专家	所有MCP功能
`debug`	开发工具	⭐⭐ 中等	调试实用程序

______________________________________________________________________

🏗️ 项目结构

📁 mcpFactory/
├── 📚 docs/                    # Comprehensive documentation
│   ├── en-us/                  # English guides
│   │   ├── 01-concepts.md      # MCP fundamentals
│   │   ├── 02-architecture.md  # Technical deep dive
│   │   ├── 03-guide.md         # Implementation guide
│   │   ├── fastmcp/            # FastMCP framework guides
│   │   │   ├── 01-introduction.md
│   │   │   ├── 02-quickstart.md
│   │   │   ├── 03-development-tools.md
│   │   │   └── 04-advanced-concepts.md
│   │   └── two-way/            # Two-way communication guides
│   │       ├── 01-fundamental-concepts.md
│   │       ├── 02-quick-start.md
│   │       ├── 03-understanding-existing-server.md
│   │       ├── 04-developing-new-mcp.md
│   │       ├── 05-multiple-clients.md
│   │       └── 06-practical-use-cases.md
│   └── pt-br/                  # Portuguese documentation (complete)
│       ├── 01-conceitos.md     # Conceitos fundamentais
│       ├── 02-arquitetura.md   # Arquitetura técnica
│       ├── 03-guia.md          # Guia de implementação
│       ├── 05-exemplos.md      # Exemplos práticos
│       ├── fastmcp/            # Guias do framework FastMCP
│       │   ├── 01-introducao.md
│       │   ├── 02-guia-rapido.md
│       │   ├── 03-ferramentas-de-desenvolvimento.md
│       │   └── 04-conceitos-avancados.md
│       └── two-way/            # Guias de comunicação bidirecional
│           ├── 01-conceitos-fundamentais.md
│           ├── 02-quick-start.md
│           ├── 03-entendendo-servidor-existente.md
│           ├── 04-desenvolvendo-novo-mcp.md
│           ├── 05-multiplos-clientes.md
│           └── 06-casos-de-uso-praticos.md
│
├── 🚀 src/servers/            # Production-ready MCP servers
│   ├── knowledge_assistant/    # 🌟 45 capabilities showcase
│   │   ├── server.py          # FastMCP 2.0 + real sampling
│   │   ├── core/              # Knowledge base & models
│   │   ├── modules/           # MCP feature modules  
│   │   └── data/              # Real sample data
│   ├── two_way/               # ⭐ Bidirectional communication
│   ├── hello_world/           # Basic MCP example
│   ├── ping_pong/             # Communication patterns
│   └── debug/                 # Development tools
│
├── 🛠️ templates/              # Ready-to-use templates
│   ├── starter.py             # Basic MCP server template
│   ├── interactive.py         # Two-way communication template
│   └── production.py          # Enterprise-grade template
│
├── 🔧 scripts/                # Development tools
│   └── start-inspector.sh     # One-click Inspector launcher
│
└── 📋 Project files
    ├── pyproject.toml          # UV/Python configuration
    ├── uv.lock                 # Dependency lock file
    ├── CHANGELOG.md            # Version history
    ├── CONTRIBUTING.md         # Contribution guide
    └── ROADMAP.md              # Future plans

______________________________________________________________________

✨ 主要特点

🔄 双向通信

传统的MCP是单向的。我们已经实施 真正的双向沟通:

graph LR
    subgraph "❌ Traditional MCP"
        A1[Client] -->|Question| B1[Server]
        B1 -->|Response| A1
    end
    
    subgraph "✅ Two-Way MCP"  
        A2[Client] -->|"Analyze code"| B2[Server]
        B2 -->|"What type of analysis?"| A2
        A2 -->|"Security"| B2
        B2 -->|"Found 3 vulnerabilities"| A2
    end
    
    style B2 fill:#e8f5e8

🧠 真实LLM采样（FastMCP 2.0）

@server.tool()
async def generate_summary(topic: str, ctx: Context = None) -> dict:
    """Generate real summaries using client's LLM via ctx.sample()"""
    result = await ctx.sample(
        prompt=f"Summarize: {topic}",
        max_tokens=400,
        model_preferences={
            "intelligence_priority": 0.8,
            "speed_priority": 0.5,
            "cost_priority": 0.2
        }
    )
    return {"summary": result.text, "model": result.model}

🏭 生产架构

✅ FastMCP 2.0 具有真实的采样支持
✅ Pydantic v2 数据验证
✅ 会话管理 适用于多用户场景
✅ 外部API集成 （维基百科，ArXiv，新闻）
✅ 错误处理 优雅的退化
✅ 综合测试 -所有功能均已验证

🛠️ 开发工具

🎯 一键式检查器 -自动启动带有配置的Chrome
📊 高级日志记录 -详细的调试信息
🔧 热重新加载 -自动重启开发模式
📚 可视化文档 -美人鱼图和指南

______________________________________________________________________

🎮 用例和示例

🔍 你能建造什么

mindmap
  root((MCP Factory))
    Production Systems
      Knowledge Management
      Document Processing  
      Code Analysis
      Data Integration
    Interactive Tools
      Smart Surveys
      Contextual Assistants
      Educational Platforms
      Customer Support
    Enterprise Solutions
      Multi-user Systems
      Session Management
      API Orchestration
      Workflow Automation

📈 实际应用

📚 知识管理：使用上下文进行智能文档检索
💻 代码助手：交互式代码分析和建议
🎓 教育工具：双向反馈的适应性学习
🏢 企业集成：通过MCP进行多系统编排
🤖 AI工作流程：复杂的多步骤人工智能交互

______________________________________________________________________

🌟 为什么选择MCP工厂？

🚀 加速发展

完整的基础：所有MCP图案集中在一个地方
生产模板：企业就绪起点
经过验证的架构：经过实战检验的设计
丰富的示例：从基础到高级实现

📚 教育卓越

进步学习：从世界到知识助理
可视化文档：美人鱼图和流程图
最佳实践：行业标准图案
故障排除指南：常见问题已解决

🔧 开发者体验

现代工具：UV包管理器，FastMCP 2.0
一键安装：自动检查器配置
热重新加载：快速迭代的开发模式
综合测试：对您的实施充满信心

______________________________________________________________________

🚀 高级用法

🔄 双向通信服务器

# Run bidirectional server
cd src/servers/two_way
uv run python server.py

# Test interactive features
# → start_survey: Begins interactive conversation
# → The server asks YOU questions!

🧠 知识助理与真正的法学硕士

# Full-featured server with 45 capabilities
cd src/servers/knowledge_assistant  
uv run python server.py

# Try these amazing features:
# → generate_summary: Real LLM summarization
# → search_knowledge: RAG-like knowledge retrieval
# → fetch_wikipedia: External API integration
# → ask_question: Interactive Q&A sessions

🏭 生产部署

# Use enterprise template
cp templates/production.py my_server.py

# Customize for your needs
# → Session management included
# → Error handling built-in  
# → External API patterns ready
# → Multi-user support enabled

______________________________________________________________________

📖 文档

🎯 快速参考

🚀 入门指南 -逐步实施
🏗️ 建筑 -技术深潜
💡 概念 -MCP基础
🌟 例子 -实例

🎯 专业指南

⚡ FastMCP框架 -现代MCP发展
🔄 双向通信 -双向图案
🧠 知识助理 -完整展示

📚 完整文档图

第节	英语	葡萄牙语	焦点
核心概念	en-us/01-concepts.md	zh-cn/01-概念.md	MCP基础
建筑	en-us/02-architecture.md	pt br/02-arquitectura.md	技术设计
实施	en-us/03-guide.md	pt br/03-guia.md	分步指南
FastMCP框架	en-us/fastmcp/	pt-br/fastmcp/	现代发展
双向通信	en-us/双向/	pt-br/双向/	双向图案
实例	-	pt br/05-exemployers.md	实际使用案例

🎯 文件亮点

📖 全覆盖：24+综合指南
🌍 双语的：英文和葡萄牙文版本
📊 视觉学习：美人鱼图和流程图
🚀 渐进复杂性：从hello_world到生产系统
💡 最佳实践：行业标准实施模式

______________________________________________________________________

🤝 贡献

我们欢迎捐款！MCP工厂旨在成为MCP开发的决定性基础。

🎯 贡献领域

🌟 新服务器示例 适用于不同的用例
📚 文档改进 和翻译
🔧 开发工具 增强
🧪 测试和验证 改进
🏭 生产模板 适用于各种场景

📝 入门指南

分叉存储库
查看我们的贡献指南
参与问题和PR的讨论
帮助我们建立最好的MCP基础！

______________________________________________________________________

📞 支持与社区

🐛 常见问题及解决方案

问题	解决方案
CORS 错误	使用Chrome/Firefox（不是Safari）
端口已在使用中	更改服务器配置中的端口
检查员无法连接	快跑 `./scripts/start-inspector.sh`
缺少依赖项	快跑 `uv sync` 在项目目录中

💬 获取帮助

📖 检查文件：90%的问题在我们的指南中得到了回答
🔍 搜索问题许多问题以前都解决过
📋 遵循示例：逐步实现可用
🎯 简单开始：从hello_world开始，逐步过渡到复杂的示例

______________________________________________________________________

🏆 项目影响

MCP工厂 将完整的MCP生态系统整合到一个结构化的基础上，实现生产就绪的AI集成的快速开发。

graph TD
    A[🏗️ Complete Foundation] --> E[🚀 Rapid Development]
    B[🔧 Production Templates] --> E
    C[💡 Proven Patterns] --> E  
    D[📚 Rich Documentation] --> E
    
    E --> F[🌟 Your Success]
    
    style F fill:#e8f5e8,stroke:#4caf50,stroke-width:3px

🎯 基金会福利

⚡ 开发速度提高10倍：跳过样板，从工作代码开始
🏭 生产就绪：内置企业模式
🧠 教育价值：通过渐进式示例学习MCP
🔄 面向未来：双向通信等尖端功能

______________________________________________________________________

📄 许可证

MIT许可证-在您的项目中自由使用！看许可证了解详情。

______________________________________________________________________

⭐ 标记此回购 如果MCP Factory加速您的AI开发！

🔧 开始建立：克隆，运行 ./scripts/start-inspector.sh，并探索我们的45功能知识助理！

mcpfactory (Maugus2)

快速接入

详细介绍

🏭 MCP工厂

🎯 什么是MCP工厂？

🚀 快速开始

⚡ 试用知识助手 （推荐）

🧪 测试功率

📊 里面是什么？

🌟 知识助理 -皇冠上的宝石

🏗️ 完成服务器收集

🏗️ 项目结构

✨ 主要特点

🔄 双向通信

🧠 真实LLM采样 （FastMCP 2.0）

🏭 生产架构

🛠️ 开发工具

🎮 用例和示例

🔍 你能建造什么

📈 实际应用

🌟 为什么选择MCP工厂？

🚀 加速发展

📚 教育卓越

🔧 开发者体验

🚀 高级用法

🔄 双向通信服务器

🧠 知识助理与真正的法学硕士

🏭 生产部署

📖 文档

🎯 快速参考

🎯 专业指南

📚 完整文档图

🎯 文件亮点

🤝 贡献

🎯 贡献领域

📝 入门指南

📞 支持与社区

🐛 常见问题及解决方案

💬 获取帮助

🏆 项目影响

🎯 基金会福利

📄 许可证

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

⚡ 试用知识助手（推荐）

🧠 真实LLM采样（FastMCP 2.0）