Docs MCP Server

🚀 MCP 服務器示例

本倉庫提供了一個實現模型上下文協議（MCP）服務器的代碼示例，展示瞭如何構建一個功能性的 MCP 服務器，以實現與各種大語言模型（LLM）客戶端的集成。

🚀 快速開始

安裝 uv 包管理器

在 MacOS/Linux：

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

在 Windows：

pip install uv

安裝完成後請重新啟動終端，以確保 uv 命令生效。

項目設置

1. 克隆並初始化項目：

# 創建新目錄用於我們的項目
git clone https://github.com/wolderufael/docs-MCP-server.git
cd docs-mcp-server

# 創建虛擬環境並激活它
uv venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate

2. 安裝依賴項：

uv venv sync 

運行服務器

1. 啟動 MCP 服務器：

uv run main.py

2. 服務器啟動後即可接受連接

✨ 主要特性

什麼是MCP？

MCP（Model Context Protocol）是一種開放協議，標準化了應用程序向 LLM 提供上下文的方式。可以將其視為人工智能應用中的 USB - C 端口——它提供了一種標準方式，以便 AI 模型能夠連接到不同的數據源和服務工具。

核心優勢

• 一個不斷增長的預構建集成列表，允許您的 LLM 直接連接
• 靈活性以在不同 LLM 提供商和供應商之間切換
• 針對在基礎設施內保護數據的最佳實踐

架構概述

MCP 採用客戶機 - 服務器架構，主機應用程序可以連接到多個服務器：

• MCP 主機：如 Claude Desktop、IDE 或 AI 工具等，這些程序希望通過 MCP 訪問數據
• MCP 客戶端：維護與服務器一對一連接的協議客戶端
• MCP 服務器：提供特定功能的標準輕量級程序
• 數據源：可以是本地（文件、數據庫）或遠程服務（API）等，MCP 服務器可訪問的數據源

核心 MCP 概念

MCP 服務器可以提供三種主要類型的功能：

• 資源：類似於文件的可讀取數據（如 API 響應或文件內容）
• 工具：LLM 可以調用的函數（需用戶批准）
• 提示詞：預寫的模板，幫助用戶完成特定任務

📦 安裝指南

系統要求

• Python 3.10 或更高版本
• MCP SDK 1.2.0 或更高版本
• uv 包管理器

安裝 uv 包管理器

在 MacOS/Linux：

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

在 Windows：

pip install uv

安裝完成後請重新啟動終端，以確保 uv 命令生效。

項目設置

1. 克隆並初始化項目：

# 創建新目錄用於我們的項目
git clone https://github.com/wolderufael/docs-MCP-server.git
cd docs-mcp-server

# 創建虛擬環境並激活它
uv venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate

2. 安裝依賴項：

uv venv sync 

💻 使用示例

連接到 Cursor AI

1. 從官方網站安裝 Cursor AI
2. 配置 Cursor 使用您的 MCP 服務器： 編輯 .cursor\mcp.json 文件：

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

📄 許可證

此項目使用 MIT License。詳細信息請參閱 LICENSE 文件。