MCP Example

🚀 多功能計算平臺（MCP）

MCP（多功能計算平臺）是一個功能強大的工具鏈，支持多種功能的組合與擴展。本指南將詳細幫助您瞭解如何安裝、配置和使用MCP框架。

🚀 快速開始

本指南將幫助您瞭解如何安裝、配置和使用MCP框架。您可以通過本指南快速上手，利用MCP的各項功能開展項目開發。

✨ 主要特性

模型上下文

模型上下文是實現自定義業務邏輯的核心部分。它接收輸入參數並返回處理結果。

• 基本功能：執行簡單的算術運算。
• 擴展功能：支持複雜的數學計算，如冪運算、平方根和對數。

MCP框架

MCP是一個功能強大的工具鏈，支持多種功能的組合與擴展。

• 執行器：負責調用並管理工具執行。
• 工具註冊與發現：自動檢測和註冊可用工具。

工具鏈接

工具鏈接允許將多個工具串聯起來，形成複雜的處理流程。

代理工具

代理工具允許將函數調用轉發到遠程MCP服務器，實現透明訪問。

可用工具 - 計算器工具（Calculator）

• 功能：支持加、減、乘、除等基本運算。
• 高級功能：冪運算、平方根和對數計算。

📦 安裝指南

文檔中未提及安裝步驟相關內容，故跳過此章節。

💻 使用示例

基礎用法

模型上下文示例

# 加法示例
result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "add",
        "a": 5,
        "b": 3
    }
})
print(f"加法結果：{result}")  # 輸出：8

# 平方根示例
sqrt_result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "sqrt",
        "a": 16
    }
})
print(f"平方根結果：{sqrt_result}")  # 輸出：4.0

MCP框架示例

from mcp_example.core.executor import execute

# 調用計算器工具
result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "multiply",
        "a": 2,
        "b": 8
    }
})
print(f"乘法結果：{result}")  # 輸出：16

# 調用文本處理工具
text_result = execute({
    "name": "transform_text",
    "parameters": {
        "operation": "uppercase",
        "text": "hello world"
    }
})
print(f"轉換後的文本：{text_result}")  # 輸出：HELLO WORLD

工具鏈接示例

from mcp_example.core.executor import execute

# 步驟1：調用計算器工具計算總和
sum_result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "add",
        "a": 10,
        "b": 20
    }
})

# 步驟2：使用結果作為文本處理的輸入
text_result = execute({
    "name": "transform_text",
    "parameters": {
        "operation": "prepend",
        "text": "總和為：",
        "append_text": str(sum_result)
    }
})

print(f"最終輸出：{text_result}")  # 輸出：總和為：30

代理工具示例

from mcp_example.core.executor import execute
from mcp_example.tools.proxy import register_proxy

# 註冊代理服務
register_proxy("http://remote.mcp-server.com:5000")

# 調用遠程計算器工具
result = execute({
    "name": "calculator",
    "parameters": {
        "operation": "subtract",
        "a": 20,
        "b": 10
    }
})

print(f"減法結果：{result}")  # 輸出：10

計算器工具示例

# 多功能計算器示例
import math
operations = {
    "add": 5 + 3,
    "subtract": 5 - 3,
    "multiply": 5 * 3,
    "divide": 5 / 3,
    "power": 2 ** 3,
    "sqrt": 16 ** 0.5,
    "log": 10 ** math.log10(10)
}

for op, result in operations.items():
    print(f"{op} 結果：{execute({\"name\": \"calculator\", \"parameters\": {\"operation\": op, \"a\": operations[op]}})}")

高級用法

文檔中未提及高級用法相關代碼示例，故跳過此部分。

📚 詳細文檔

貢獻指南

參與項目

歡迎任何人參與MCP框架的開發！您可以通過以下方式貢獻：

1. 報告問題：在GitHub倉庫提交問題。
2. 功能請求：提出新功能或改進建議。
3. 代碼貢獻：為框架添加新功能或修復問題。

提交指南

• 請確保代碼符合PEP8規範。
• 提交時，請附帶詳細的變更說明。
• 簽訂貢獻者協議前，請閱讀相關條款。

聯繫方式

• 郵件：contact@mcplatform.org
• GitHub：https://github.com/mcplatform
• 論壇：https://forum.mcplatform.org

📄 許可證

本項目遵循MIT許可證，具體內容如下：

MIT License

版權 © [年份] [作者姓名]

特此許可任何人免費使用、複製、修改、合併、發佈、分發和/或銷售本軟件及其衍生作品，但需在所有副本中保留上述版權聲明和本許可聲明。

對於本軟件及其衍生作品，DISCLAIMER OF WARRANTY：該軟件按“原樣”提供，不附帶任何明示或暗示的保證，包括但不限於適銷性、適合特定用途或無侵權的保證。

感謝您選擇MCP框架！希望本指南能幫助您順利完成項目開發。