amornpan/py-mcp-line

A Model Context Protocol server implementation in Python that provides access to LINE Bot messages. This server enables Language Models to read and analyze LINE conversations through a standardized interface.
## Features
### Core Functionality
Asynchronous operation using Python's asyncio
Environment-based configuration using python-dotenv
Comprehensive logging system
LINE Bot webhook event handling
Message storage in JSON format
FastAPI integration for API endpoints
Pydantic models for data validation
Support for text, sticker, and image messages
## Prerequisites
Python 3.8+
Required Python packages:
fastapi
pydantic
python-dotenv
mcp-server
line-bot-sdk
uvicorn
## Installation
bash
git clone https://github.com/amornpan/py-mcp-line.git
cd py-mcp-line
pip install -r requirements.txt
## Project Structure
PY-MCP-LINE/
├── src/
│ └── line/
│ ├── init.py
│ └── server.py
├── data/
│ └── messages.json
├── tests/
│ ├── init.py
│ └── testline.py
├── .env
├── .env.example
├── .gitignore
├── README.md
├── Dockerfile
└── requirements.txt
### Directory Structure Explanation
src/line/ - Main source code directory
init.py - Package initialization
server.py - Main server implementation
data/ - Data storage directory
messages.json - Stored LINE messages
tests/ - Test files directory
init.py - Test package initialization
testline.py - LINE functionality tests
.env - Environment configuration file (not in git)
.env.example - Example environment configuration
.gitignore - Git ignore rules
README.md - Project documentation
Dockerfile - Docker configuration
requirements.txt - Project dependencies
## Configuration
Create a .env file in the project root:
env
LINECHANNELSECRET=yourchannelsecret
LINEACCESSTOKEN=youraccesstoken
SERVERPORT=8000
MESSAGESFILE=data/messages.json
## API Implementation Details
### Resource Listing
python
@app.listresources()
async def listresources() -> list[Resource]
Lists available message types from the LINE Bot
Returns resources with URIs in the format line:// /data
Includes resource descriptions and MIME types
### Resource Reading
python
@app.readresource()
async def readresource(uri: AnyUrl) -> str
Reads messages of the specified type
Accepts URIs in the format line:// /data
Returns messages in JSON format
Supports filtering by date, user, or content
## Usage with Claude Desktop
Add to your Claude Desktop configuration:
On MacOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
On Windows: %APPDATA%/Claude/claudedesktopconfig.json
json
"mcpServers": {
"line": {
"command": "python",
"args": [
"server.py"
],
"env": {
"LINECHANNELSECRET": "yourchannelsecret",
"LINEACCESSTOKEN": "youraccesstoken",
"SERVERPORT": "8000",
"MESSAGESFILE": "data/messages.json"
## Error Handling
The server implements comprehensive error handling for:
Webhook validation failures
Message storage errors
Resource access errors
URI validation
LINE API response errors
All errors are logged and returned with appropriate error messages.