MCP Server

🚀 MCP-Server

MCP-Server 是一個作為應用程序後端的項目。它實現了 Model Context Protocol (MCP)，允許像 LM Studio 這樣的 AI 模型與本地數據和自定義工具進行安全交互。例如，該服務器可以處理 CSV 和 Parquet 格式的數據，並提供數據處理和分析工具。

🚀 快速開始

安裝依賴

強烈建議使用 uv 來安裝和管理依賴，因為它是一個快速且現代的 Python 項目管理器。

1. 安裝 uv： 確保您的系統已安裝 uv。若未安裝，可按以下方式進行安裝：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   對於 Windows（若未安裝 curl）：

   pip install uv
   

   或者

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

   重新啟動終端，使 uv 命令可用。使用 uv --version 檢查安裝情況。
2. 克隆倉庫：

   git clone <repository-url>
   cd mcp-server
   

3. 設置虛擬環境並安裝依賴：

   uv venv
   .venv\Scripts\activate # 在 MacOS 或 Linux 上：source .venv/bin/activate
   uv pip install -r requirements.txt
   

啟動 MCP 服務器

要啟動 MCP 服務器，請導航到項目根目錄並執行以下命令：

uv run main.py

服務器現在將等待來自客戶端（如 LM Studio）的連接。不過，服務器無需一直運行，因為 LM Studio 可以在需要時自動（在後臺）啟動它。

與 LM Studio 集成

要將 LM Studio 與您的 MCP 服務器連接，需要調整 LM Studio 的配置文件。

1. 編輯 LM Studio 中的 mcp.json： 編輯 LM Studio 中的 mcp.json 文件。
2. 將服務器添加到配置中： 將以下 JSON 代碼添加到 mcp.json 文件中，並將 /ABSOLUTE/PATH/TO/mcp-server 替換為您項目文件夾的實際絕對路徑。確保 uv 在系統路徑中，或者提供 uv 可執行文件的完整路徑：

   {
     "mcpServers": {
       "mcp-server": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/mcp-server",
           "run",
           "main.py"
         ]
       }
     }
   }
   

3. 重啟 LM Studio： 重啟 LM Studio 後，您的 MCP 服務器工具應該可用。檢查 LM Studio 的設置或界面，找到已註冊的工具（summarize_csv_file、summarize_parquet_file）。

在 LM Studio 中進行示例查詢

現在您可以要求 LM Studio 使用您的工具，例如：

• "總結名為 sample.csv 的 CSV 文件。"
• "sample.parquet 有多少行？"

✨ 主要特性

• 實現了 Model Context Protocol (MCP)，支持 AI 模型與本地數據和自定義工具進行安全交互。
• 可以處理 CSV 和 Parquet 格式的數據，並提供數據處理和分析工具。

📦 安裝指南

見快速開始部分的安裝依賴步驟。

💻 使用示例

基礎用法

啟動 MCP 服務器：

uv run main.py

在 LM Studio 中使用工具：

"總結名為 `sample.csv` 的 CSV 文件。"

📚 詳細文檔

項目結構

• main.py：啟動 MCP 服務器的主文件。
• server.py：包含 MCP 服務器的邏輯，並註冊工具。
• generate_parquet.py：用於從其他數據源（如 sample.csv）生成 Parquet 文件的腳本。
• data/：示例數據目錄（sample.csv、sample.parquet）。
• tools/：包含 MCP 工具定義：
  • csv_tools.py：處理 CSV 文件的函數。
  • parquet_tools.py：處理 Parquet 文件的函數。
• utils/：包含可重複使用的輔助函數，用於讀取文件：
  • file_reader.py：讀取 CSV 和 Parquet 文件並總結其內容的輔助函數。
• pyproject.toml：項目配置文件，管理項目的依賴項。
• uv.lock：依賴項的鎖定文件，由 uv 生成。

數據

示例數據位於 data/ 目錄中。

工具

此目錄（csv_tools.py、parquet_tools.py）中的工具主要用於通過 main.py 和 server.py 與 MCP 服務器集成。無需直接運行這些工具，因為 MCP 服務器會在需要時調用它們。

實用工具 (utils/)

utils/ 目錄包含可重複使用的輔助函數（如 file_reader.py），供工具用於處理和總結數據。

🔧 技術細節

本項目基於 Python 開發，使用 uv 作為項目管理器。實現了 Model Context Protocol (MCP)，使得 AI 模型能夠與本地數據和自定義工具進行交互。通過 server.py 註冊工具，main.py 啟動服務器，tools/ 目錄下的工具可以處理 CSV 和 Parquet 格式的數據，utils/ 目錄下的輔助函數提供了文件讀取和內容總結的功能。

📄 許可證

原文檔未提及許可證信息。

致謝

本項目受到了 @llm-guy 的啟發。參考文章：Building a Basic MCP Server with Python 。