Mcpadapt

🚀 MCPAdapt 中文文檔

MCPAdapt 是一個強大的適配器，用於將各類模型和工具與不同的對話式人工智能框架相連接。它支持多種主流人工智能框架，用戶只需簡單配置，就能調用遠程或本地 MCP 服務器上的工具，極大提升了使用效率和靈活性。

🚀 快速開始

安裝指南

使用 pip 即可輕鬆完成安裝：

pip install mcpadapt

基本使用

from mcpadapt import MCPAdapt

# 初始化適配器
adapter = MCPAdapt()

# 註冊工具
adapter.register_tool(tool_name, tool_function)

# 調用工具
result = adapter.call_tool(tool_name, parameters)

支持的框架

• Smolagents
• LangChain
• CrewAI
• Google GenAI

✨ 主要特性

1. 多框架支持：能夠輕鬆連接多種流行的人工智能框架，為用戶提供更多選擇。
2. 靈活配置：通過簡單的參數配置，就能調用 MCP 服務器上的工具，降低使用門檻。
3. 擴展性強：易於添加新的框架和工具支持，方便項目的後續發展。

💻 使用示例

基礎用法

from mcpadapt import MCPAdapt

# 初始化適配器並連接到遠程 MCP 服務器
adapter = MCPAdapt(remote_server="your-mcp-server-url")

# 定義一個簡單的工具函數
def your_tool_function(parameters):
    # 處理參數並返回結果
    return {"result": "tool executed successfully"}

# 註冊工具
adapter.register_tool("your_tool_name", your_tool_function)

# 調用工具
response = adapter.call_tool("your_tool_name", parameters={"key": "value"})

print(response)

高級用法

from mcpadapt import MCPAdapt, serve

# 初始化適配器並啟動本地 MCP 服務器
adapter = MCPAdapt()
serve(adapter, port=8000)

# 定義一個簡單的工具函數
def your_tool_function(parameters):
    # 處理參數並返回結果
    return {"result": "tool executed successfully"}

# 註冊工具
adapter.register_tool("your_tool_name", your_tool_function)

📚 詳細文檔

貢獻

如果您發現有任何問題或有改進的建議，請隨時提交 Issue 或 Pull Request。

如何添加新的框架支持

1. 創建適配器類：在 src/mcpadapt/{name_of_your_framework}_adapter.py 中創建一個新的適配器類：

from mcpadapt.base_adapter import ToolAdapter
from typing import Callable, Any

class YourFrameworkAdapter(ToolAdapter):
    def adapt(
        self,
        func: Callable[[dict | None], mcp.types.CallToolResult],
        mcp_tool: mcp.types.Tool,
    ) -> YourFramework.Tool:
        # 實現如何將簡單的函數和 MCP 工具（JSON Schema）轉換為您的框架工具
        pass
    
    def async_adapt(
        self,
        afunc: Callable[[dict | None], Coroutine[Any, Any, mcp.types.CallToolResult]],
        mcp_tool: mcp.types.Tool,
    ) -> YourFramework.Tool:
        # 如果您的框架支持異步函數，使用 async_adapt
        pass

2. 測試和提交：實現完成後，請確保添加相應的測試用例，並提交到倉庫以與社區共享。

項目 roadmap

• 已完成：

  • 初始框架，支持多種適配器創建。
  • 支持 Smolagents、LangChain、CrewAI 和 Google GenAI 等主流框架。
  • 支持遠程 MCP 服務器和本地服務器的連接。

• 未來計劃：

  • 增加對更多 AI 框架的支持（如 Pydantic-OpenAI）。
  • 改進文檔，增加更多示例和教程。
  • 提升性能和穩定性。

貢獻者

我們感謝每一位為該項目做出貢獻的開發者和維護者：

核心維護者：

• @grll

貢獻者：

• @murawakimitsuhiro
• @joejoe2
• @tisDDM
• @sysradium

感謝您對 MCPAdapt 的支持！

📄 許可證

本項目的許可證信息可通過 查看。