什麼是MCP服務器？

模型上下文協議（MCP）是一個框架，允許將自定義工具集成到AI輔助的開發環境中。此Python實現提供了一些功能，如簡單的計算和環境變量檢索，以便LLM-based IDEs能夠使用。

如何使用MCP服務器？

該服務器可以與Cursor AI等IDE集成，以提供按需工具執行。開發人員可以通過自然語言提示在IDE中調用工具。

應用場景

適用於使用AI輔助IDE的開發者，他們需要通過自定義工具擴展功能，如計算、環境管理或其他重複性任務。

功能特性

支持基本的算術運算，如加法、減法、乘法和除法。

允許從系統中讀取和檢索環境變量值。

與主流的AI輔助開發環境無縫集成，提供即時工具支持。

優缺點分析

使用指南

首先，安裝所需的依賴項：運行pip install mcp mcp[cli]。

創建一個新目錄並初始化項目。

在項目根目錄下創建mcp.json配置文件，添加所需的工具定義。

啟動MCP服務器並連接到IDE進行測試。

使用示例

常見問題解答

什麼是模型上下文協議（MCP）？

如何添加新的工具到服務器中？

mcp.json文件應該放在哪裡？

🚀 使用 Python 的 MCP 服務器

MCP（模型上下文協議） 是一個強大的框架，可將自定義工具集成到 AI 輔助開發環境，如 Cursor AI 中。本項目的 MCP 服務器使用 Python 構建，能暴露數據檢索、代碼分析等功能，供 LLM 基 IDE 按需調用。它提供兩個實用功能：add 可計算兩數之和，getApiKey 能從環境變量中獲取 API 密鑰。更多詳情可查看模型上下文協議簡介。

🚀 快速開始

本項目使用 Python 構建 MCP 服務器，為你展示如何將自定義工具集成到 AI 輔助開發環境中。

✨ 主要特性

MCP 集成：為 LLM 基 IDE 提供實用功能。
加法工具：接收兩個數字參數並返回它們的和。
環境變量檢索：演示如何從配置文件加載示例環境變量。
CLI 支持：通過 mcp[cli] 提供命令行界面，便於本地開發和測試。
標準 I/O 運輸：利用標準 I/O 與開發環境集成，實現無縫通信。

📦 安裝指南

環境要求

Python：建議使用現代 Python 版本（3.8 或更高）。
虛擬環境：推薦使用虛擬環境進行依賴管理。

安裝步驟

克隆倉庫

git clone <repository_url>
cd <repository_directory>

設置虛擬環境
- 創建 Python 虛擬環境：
```
python -m venv .venv
```
- 在 Linux 和 macOS 上激活虛擬環境：
```
source .venv/bin/activate  # 或 .venv/bin/activate
```
- 在 Windows 上激活虛擬環境：
```
.venv\Scripts\activate
```
安裝依賴項
```
pip install -r requirements.txt
```

💻 使用示例

基礎用法

在 Python 腳本中，使用 MCP 庫初始化 MCP 服務器，並通過標準 I/O 運輸連接。以下是定義工具的示例：

# 定義 add 工具，接受兩個數字輸入並返回它們的和
def add(a, b):
    return a + b

# 定義 getApiKey 工具，從環境變量 API_KEY 中檢索 API 密鑰並返回它
import os
def getApiKey():
    return os.getenv('API_KEY')

測試 MCP 服務器

啟動 MCP 服務器

在終端中運行以下命令以啟動 MCP 服務器：

python server.py

調用工具

測試 add 工具：

echo "add 3 5" | nc -U ipc://localhost/mcp-server

測試 getApiKey 工具：

echo "getApiKey" | nc -U ipc://localhost/mcp-server

集成到 Cursor AI

配置 mcp.json 文件

在項目根目錄中創建一個 mcp.json 文件，並添加以下內容：

{
    "servers": [
        {
            "name": "local-mcp-server",
            "transport": "ipc",
            "endpoint": "ipc://localhost/mcp-server"
        }
    ],
    "tools": [
        {
            "name": "add",
            "description": "計算兩個數字的和",
            "parameters": [
                {"name": "a", "type": "number"},
                {"name": "b", "type": "number"}
            ]
        },
        {
            "name": "getApiKey",
            "description": "獲取 API 密鑰",
            "parameters": []
        }
    ]
}