Custommcpserver

構建一個自定義的Python MCP服務器，用於連接AI代理和工具，實現標準化通信和上下文管理。

人工智能聊天機器人開發者工具 #MCP協議 #AI工具 #上下文管理 #Python服務 .Python

評分 : 2分

下載量 : 3

更新時間 : 2025-04-28

什麼是MCP服務器?

MCP服務器是一種專門為AI工具和大型語言模型(LLM)設計的通信橋樑。它採用標準化的Model Context Protocol協議，使不同AI應用之間能夠安全、高效地交換數據和功能。

如何使用MCP服務器?

通過Python SDK快速構建MCP服務器，然後將其安裝到Claude等AI應用中即可使用。服務器可以暴露數據資源(Resources)和功能工具(Tools)供AI調用。

適用場景

適用於需要將自定義數據或功能集成到AI工作流的場景，如數據庫操作、自動化任務、特定領域知識查詢等。

主要功能

數據資源(Resources)類似GET端點，用於向LLM提供上下文信息

功能工具(Tools)類似POST端點，用於執行代碼或產生副作用

交互模板(Prompts)可重用的LLM交互模板，定義標準交互模式

Claude集成可直接安裝到Claude桌面應用中，實現無縫集成

優勢與侷限性

優勢

標準化協議，便於不同AI工具間的互操作

安全可控的數據和功能暴露方式

與Claude等主流AI應用深度集成

Python開發，易於擴展和定製

侷限性

目前主要支持Python生態

需要一定的開發知識來創建自定義服務器

部分AI應用可能需要重啟才能識別新安裝的服務器

如何使用

初始化項目

使用uv工具初始化Python項目

添加依賴

安裝MCP Python SDK

激活環境

激活Python虛擬環境

安裝服務器

將MCP服務器安裝到Claude應用中

重啟應用

如果服務器未顯示，需要重啟Claude應用

使用案例

AI便籤工具創建一個可以管理便籤的AI工具，允許Claude添加、查看和刪除便籤

數據庫操作連接數據庫並讓Claude自動生成和插入測試數據

常見問題

安裝後為什麼在Claude中看不到我的服務器?

如何更新已安裝的服務器?

可以同時運行多個MCP服務器嗎?

🚀 自定義 MCP 服務器

本項目使用 Python 構建一個自定義的 MCP 服務器，並將其與 AI 代理連接。MCP 服務器本質上是 LLM 和 AI 工具之間通信的方式，模型上下文協議允許應用程序以標準化的方式為 LLM 提供上下文，將提供上下文的職責與實際的 LLM 交互分離。

🚀 快速開始

資源

安裝步驟

# 創建一個由 uv 管理的項目
$ uv init .
已初始化項目 `custommcpserver` 到 `C:\Users\abhis\Desktop\AIAgents\CustomMCPServer`
# 然後將 MCP 添加到項目的依賴項中:
$ uv add "mcp[cli]"
# 激活 Python 環境
$ source .venv/scripts/activate
# 我們可以在 Claude Desktop 中安裝這個服務器並立即與之交互，運行以下命令:
# mcp install main.py
# 由於我們在 VS Code 中，我們執行
$ uv run mcp install main.py
[04/16/25 10:06:31] INFO     Added server 'Demo' to Claude config
                    INFO     Successfully installed Demo in Claude app

配置說明

打開 claude 應用 > 文件 > 設置 > 開發者 > 編輯配置 - 這會打開一個文件，然後在該文件中找到 claude_desktop_config.json 文件。
我們可以在該文件中看到 mcp run main.py 的路徑被添加到其中。
該 MCP 服務器應該顯示在 claude 應用中。如果未顯示，請執行以下操作:
- 關閉 claude 應用 - 打開任務管理器並搜索 claude，右鍵點擊並結束任務。
- 等待幾秒鐘後重新打開應用。
- 一旦應用加載，它會啟動 MCP 服務器，並且會在應用中顯示出來。請參考下方的圖像，當您點擊工具時，我們可以看到服務器:DEMO。

💻 使用示例

基礎用法

按照上述安裝步驟和配置說明操作，即可在 claude 應用中使用 MCP 服務器。

高級用法

高級 MCP 服務器

在我們繼續之前，從根本上什麼是 MCP？:
- 它使您能夠構建 服務器，以一種安全、標準化的方式為 LLM 應用程序提供數據和功能。想象一下，它類似於 Web API，但專門設計用於 LLM 交互。
  - 通過資源（可以將其視為 GET 端點；它們用於將信息加載到 LLM 的上下文中）暴露數據
  - 通過工具（類似於 POST 端點；它們用於執行代碼或產生副作用）提供功能
  - 通過提示（可重用的 LLM 交互模板）定義交互模式
  - 以及其他更多！

高級服務器安裝

$ uv add black
# 在創建新的 MCP 服務器及工具後
$ uv run mcp install adv_main.py
[04/16/25 10:44:02] INFO     Added server 'AI Sticky Notes' to Claude config
                    INFO     Successfully installed AI Sticky Notes in Claude app