Mcpx Py

🚀 mcpx-py 項目

mcpx-py 是一個強大的 Python 庫，藉助 mcp.run 工具實現與大語言模型（LLM）的交互，支持多種主流 AI 模型，為開發者提供便捷的 LLM 調用體驗。

🚀 快速開始

mcp.run 配置

你需要通過運行以下命令獲取一個 mcp.run 會話 ID：

npx --yes -p @dylibso/mcpx gen-session --write

這將生成一個新的會話並將會話 ID 寫入配置文件，該文件可用於 mcpx-py。

如果你需要將會話 ID 存儲在環境變量中，可以運行 gen-session 而不帶 --write 標誌：

npx --yes -p @dylibso/mcpx gen-session

這應該輸出類似以下內容：

登錄成功！
會話：kabA7w6qH58H7kKOQ5su4v3bX_CeFn4k.Y4l/s/9dQwkjv9r8t/xZFjsn2fkLzf+tkve89P1vKhQ

然後設置 MPC_RUN_SESSION_ID 環境變量：

$ export MPC_RUN_SESSION_ID=kabA7w6qH58H7kKOQ5su4v3bX_CeFn4k.Y4l/s/9dQwkjv9r8t/xZFjsn2fkLzf+tkve89P1vKhQ

安裝依賴項

在使用 mcpx-py 之前，確保安裝了所有必要的依賴項：

pip install mcpx

示例代碼

以下是一個完整的示例，展示瞭如何使用 mcpx-py：

from mcpx import MPX

# 初始化 MPX 實例
mpx = MPX()

# 使用不同的 LLM 模型進行推理
print(mpx.chat("What is the weather like?"))  # 使用默認模型
print(mpx.chat("What is the weather like?", model="gpt-3.5-turbo"))  # 使用指定的模型

# 處理結構化輸出
response = mpx.chat("Tell me a joke.", result_type=dict)
print(response)

✨ 主要特性

支持的 AI 提供程序

mcpx-py 支持所有由 PydanticAI 支持的模型。

📦 安裝指南

Python 使用說明

在使用 mcpx-py 之前，確保安裝了所有必要的依賴項：

pip install mcpx

命令行使用說明

工具安裝

使用 uv 包管理器安裝

將 mcpx 添加到你的 uv 配置文件（通常位於 ~/.config/uv.json）：

{
  "dependencies": {
    "mcpx": "*"
  }
}

然後運行以下命令進行安裝：

uv install

使用 npm 包管理器安裝

雖然主要通過 pip 安裝，但你也可以使用 npm 進行安裝（儘管這不是推薦的方式）：

npm install mcpx-py

基本用法

與 LLM 對話

運行以下命令開始與 LLM 對話：

mcpx-client chat

獲取幫助信息

如果你需要更多信息，可以運行：

mcpx-client --help

📚 詳細文檔

LLM 配置指南

支持的模型及其配置方法

使用 Gemini 模型

1. 在 Gemini 上創建一個賬戶。
2. 生成 API 密鑰並按照說明使用。

使用 Ollama

1. 下載 Ollama 並安裝：ollama.ai
2. 拉取所需的模型，例如：

ollama pull llama3.2

3. 設置為默認模型：

ollama config default=llama3.2

使用 Llamafile

1. 下載一個 Llamafile 模型：llamafile
2. 將文件設置為可執行：

chmod +x your-model.llamafile

3. 以 JSON API 模式運行：

./your-model.llamafile --json-api --host 127.0.0.1 --port 8080

4. 使用 OpenAI 提供程序指向本地服務地址：http://localhost:8080

支持的模型列表

• gpt-3.5-turbo
• llama2
• llama3
• llama3.2

設置 API 密鑰

將你的 API 密鑰添加到環境變量中，例如：

export OPENAI_API_KEY="your-api-key"

這樣，你就可以使用這些模型進行交互了。通過以上步驟，你可以輕鬆配置和使用各種 LLM 模型，滿足不同的開發需求。

🔧 技術細節

依賴項

• uv
• npm
• ollama（可選）