MCP Servers Fbl

🚀 MCP（Model Context Protocol）項目

MCP（Model Context Protocol）是一種通用的人工智能接口協議，類似於USB - C。它能讓MCP服務器作為外部設備連接到AI系統，實現一次開發多處使用。MCP客戶端嵌入在AI宿主中，負責與服務器交互，調用工具、查詢資源和處理提示。該項目旨在構建基於MCP的AI基礎設施，連接AI模型與即時結構化知識，擴展其功能並增強代理組合能力。

🚀 快速開始

MCP項目構建了一個基於MCP協議的AI基礎設施。要快速瞭解其工作原理，可參考以下MCP客戶端與服務器的交互邏輯：

• MCP客戶端：嵌入在AI宿主（如Claude Desktop）中，負責發起工具請求、查詢資源以及處理提示。
• MCP服務器：本地實現的服務器，暴露工具、資源和提示供AI客戶端使用。

✨ 主要特性

通用AI接口

MCP的功能類似於USB - C，允許外部AI應用程序通過插件形式連接到各種AI系統。MCP服務器可以作為一個獨立的外部設備，提供特定功能供AI客戶端調用。

客戶端與服務器交互

• MCP客戶端：作為AI系統與MCP服務器之間的橋樑，請求工具、查詢資源、處理提示。
• MCP服務器：暴露工具（如天氣API）供AI客戶端動態調用，提供資源（如API響應、數據庫查詢結果），處理提示以實現結構化用戶交互。

代理組合能力

MCP架構支持多層代理交互，其中AI代理可以同時充當MCP客戶端和服務器。這種設計使得專門化的模塊能夠獨立處理不同的任務，從而實現更復雜的操作。

自我演化AI

未來的迭代可能會引入動態工具發現功能，允許AI客戶端即時註冊和發現新的MCP能力。這將使系統更加靈活，能夠根據需求自動擴展功能。

開發與調試支持

利用Anthropic的MCP Inspector進行交互式測試和調試，無需完整的部署環境。這對於快速開發和問題排查非常有用。

📚 詳細文檔

項目背景

MCP是一種通用的人工智能接口協議，類似於USB - C。MCP服務器可以作為外部設備連接到AI系統（如Claude Desktop或雲應用程序），實現一次開發、多處使用的功能。MCP客戶端嵌入在AI宿主中，負責通過MCP協議與服務器進行1:1交互。MCP客戶端可以調用工具、查詢資源並插入提示；而MCP服務器則暴露工具（由模型控制：檢索、數據庫更新、發送）、資源（由應用程序控制：數據庫記錄、API）以及提示（由用戶控制：文檔）。

項目目標

構建一個基於MCP的AI基礎設施，連接AI模型與即時結構化知識，通過自定義工具執行擴展其功能，並增強代理組合能力。目標是創建一個具有適應性和插件式架構的動態AI系統，能夠集成到多個宿主中，並通過工具註冊和即時發現進行演化。

項目架構

MCP作為通用AI接口

MCP充當一種互操作性層，允許外部AI應用程序（如Claude、Cursor等）與結構化數據源和可執行函數交互。它採用類似於USB - C的架構，其中MCP服務器作為一個外部插件，可以連接到各種AI系統。

MCP客戶端與服務器角色

MCP客戶端（嵌入在AI宿主中）

• 請求工具
• 查詢資源
• 處理提示
• 作為AI系統與MCP服務器之間的橋樑

MCP服務器（本地實現）

• 暴露工具（如天氣API）供AI客戶端動態調用
• 提供資源（如API響應、數據庫查詢結果）
• 處理提示以實現結構化用戶交互

MCP架構與工作流程

MCP作為通用AI接口

MCP的功能類似於USB - C，允許外部AI應用程序通過插件形式連接到各種AI系統。MCP服務器可以作為一個獨立的外部設備，提供特定功能供AI客戶端調用。

MCP客戶端與服務器交互

• MCP客戶端：嵌入在AI宿主（如Claude Desktop）中，負責發起工具請求、查詢資源以及處理提示。
• MCP服務器：本地實現的服務器，暴露工具、資源和提示供AI客戶端使用。

關鍵功能與未來增強

代理組合能力

MCP架構支持多層代理交互，其中AI代理可以同時充當MCP客戶端和服務器。這種設計使得專門化的模塊能夠獨立處理不同的任務，從而實現更復雜的操作。

自我演化AI通過註冊API

未來的迭代可能會引入動態工具發現功能，允許AI客戶端即時註冊和發現新的MCP能力。這將使系統更加靈活，能夠根據需求自動擴展功能。

開發與調試支持

利用Anthropic的MCP Inspector進行交互式測試和調試，無需完整的部署環境。這對於快速開發和問題排查非常有用。

結論

本項目構建了一個基於MCP的AI基礎設施，將AI模型連接到即時結構化知識，並通過自定義工具執行擴展其能力。目標是創建一個具有適應性和插件式架構的動態AI系統，能夠集成到多個宿主中，並通過工具註冊和即時發現進行演化。

總結

通過MCP協議，我們可以實現一個靈活且高度可擴展的AI系統，支持即時交互、動態功能擴展以及多層代理協作。這種架構不僅適用於個人開發，也可以應用於企業級AI平臺的構建。

💻 使用示例

基礎用法

# 示例：簡單的MCP服務器端實現
class MCPServer:
    def __init__(self):
        self.tools = []
        self.resources = []
        self.prompts = []

    def register_tool(self, tool):
        self.tools.append(tool)
        print(f"工具已註冊: {tool}")

    def get_resource(self, resource_id):
        for res in self.resources:
            if res["id"] == resource_id:
                return res
        return None

    def handle_prompt(self, prompt):
        # 處理提示的邏輯
        pass

# 示例：簡單的MCP客戶端實現
class MCPClient:
    def __init__(self, server):
        self.server = server

    def call_tool(self, tool_id):
        for tool in self.server.tools:
            if tool["id"] == tool_id:
                return tool["function"]()
        return None

    def query_resource(self, resource_id):
        return self.server.get_resource(resource_id)

    def send_prompt(self, prompt):
        self.server.handle_prompt(prompt)

高級用法

目前文檔未提供高級用法示例，後續可根據MCP協議的動態工具發現等未來增強功能進行補充。

🔧 技術細節

實現細節

開發“Vibe”代碼

以下是MCP協議的一些示例代碼實現，展示了簡單的MCP服務器端和客戶端的實現邏輯：

# 示例：簡單的MCP服務器端實現
class MCPServer:
    def __init__(self):
        self.tools = []
        self.resources = []
        self.prompts = []

    def register_tool(self, tool):
        self.tools.append(tool)
        print(f"工具已註冊: {tool}")

    def get_resource(self, resource_id):
        for res in self.resources:
            if res["id"] == resource_id:
                return res
        return None

    def handle_prompt(self, prompt):
        # 處理提示的邏輯
        pass

# 示例：簡單的MCP客戶端實現
class MCPClient:
    def __init__(self, server):
        self.server = server

    def call_tool(self, tool_id):
        for tool in self.server.tools:
            if tool["id"] == tool_id:
                return tool["function"]()
        return None

    def query_resource(self, resource_id):
        return self.server.get_resource(resource_id)

    def send_prompt(self, prompt):
        self.server.handle_prompt(prompt)

圖片說明

• 圖片1：MCP協議的整體架構圖，展示了客戶端與服務器之間的交互流程。
• 圖片2：MCP工具註冊與調用的示意圖，展示瞭如何動態註冊和調用不同功能。