Python Line Server

🚀 Python LINE MCP 服務器

本項目是一個用 Python 實現的模型上下文協議（Model Context Protocol）服務器，它能提供對 LINE 機器人消息的訪問。藉助標準化接口，語言模型可閱讀並分析 LINE 對話，為相關開發工作提供了便利。

🚀 快速開始

先決條件

以下組件需安裝並配置：

• Python 3.8+
• FastAPI 0.104.1 或更高版本
• Uvicorn 0.34.0 或更高版本
• Pydantic 2.10.6 或更高版本
• LINE Bot SDK 3.5.0 或更高版本

安裝

創建一個 requirements.txt 文件，內容如下：

fastapi>=0.104.1
pydantic>=2.10.6
uvicorn>=0.34.0 
python-dotenv>=1.0.1
line-bot-sdk>=3.5.0
anyio>=4.5.0
mcp==1.2.0

運行以下命令安裝依賴：

pip install -r requirements.txt

配置

創建一個 .env 文件，內容如下：

# 線上模式配置（推薦）
IS_PRODUCTION=true
LINE_CHANNEL_ID=your_channel_id
LINE_CHANNEL_SECRET=your_channel_secret
LINE_API_ENDPOINT=https://api.line.me
MCP_SERVER_URL=http://localhost:8000

# 或者開發模式：
IS_PRODUCTION=false
LINE_CHANNEL_ID=your_channel_id
LINE_CHANNEL_SECRET=your_channel_secret

將 your_channel_id 和 your_channel_secret 替換為你的 LINE 機器人憑證。

初始化服務器

uvicorn app.main:app --reload

訪問接口

• 列出所有資源：curl http://localhost:8000/mcp/resources
• 獲取特定資源：curl http://localhost:8000/mcp/resources/{id}

✨ 主要特性

核心功能

• 使用 Python 的 asyncio 進行異步操作
• 環境配置使用 python-dotenv
• 符合 Model Context Protocol 1.2.0 標準
• 集成 LINE Messaging API
• 提供 RESTful API 接口

📦 安裝指南

創建一個 requirements.txt 文件，內容如下：

fastapi>=0.104.1
pydantic>=2.10.6
uvicorn>=0.34.0 
python-dotenv>=1.0.1
line-bot-sdk>=3.5.0
anyio>=4.5.0
mcp==1.2.0

運行以下命令安裝依賴：

pip install -r requirements.txt

💻 使用示例

基礎用法

# 初始化服務器
uvicorn app.main:app --reload

# 訪問接口
# 列出所有資源
curl http://localhost:8000/mcp/resources
# 獲取特定資源
curl http://localhost:8000/mcp/resources/{id}

📚 詳細文檔

項目結構

以下是項目的文件夾和文件結構：

your_project/
├── app/                       # FastAPI 應用代碼
│   ├── main.py               # FastAPI 應用入口
│   └── routes/               # 路由定義
│       └── line_mcp.py      # LINE MCP 路由
├── config/                   # 配置文件
│   ├── .env                 # 環境變量配置
│   └── mcp_config.yml       # MCP 配置
└── utils/                    # 工具函數
    └── line_bot_utils.py     # LINE 機器人工具

API 實現細節

資源列表接口

@app.get("/mcp/resources")
def list_resources():
    # 獲取所有資源信息
    resources = get_all_resources()
    return {"status": "success", "data": resources}

資源讀取接口

@app.get("/mcp/resources/{resource_id}")
def read_resource(resource_id: str):
    # 讀取特定資源內容
    resource_content = fetch_resource_by_id(resource_id)
    return {"status": "success", "data": resource_content}

資源創建接口

@app.post("/mcp/resources")
def create_resource(resource_data: ResourceData):
    # 創建新資源
    new_resource = create_new_resource(resource_data)
    return {"status": "success", "data": new_resource}

🔧 技術細節

錯誤處理

該服務器包含完善的錯誤處理機制，包括：

• 參數驗證
• 資源不存在異常
• 權限檢查
• 網絡連接異常

安全特性

支持以下安全措施：

• 環境變量配置
• 訪問控制列表（ACL）
• 日誌記錄和監控
• 數據加密傳輸

📄 許可證

本項目基於 MIT 協議開源，使用前請仔細閱讀相關文檔和 LICENSE 文件。

聯繫方式

Amornpan Phornchaicharoen

如有任何問題或合作意向，請隨時聯繫我。

⚠️ 重要提示

本項目基於 MIT 協議開源，使用前請仔細閱讀相關文檔和 LICENSE 文件。