JinDaGe - python-line-server MCP Details

article

README

🚀 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 文件。

python-line-server