What is Py Mcp Line

py-mcp-line is a Python implementation of a Model Context Protocol (MCP) server that facilitates access to LINE Bot messages, allowing Language Models to read and analyze LINE conversations through a standardized interface.

Use cases

Use cases for py-mcp-line include developing LINE chatbots, analyzing user interactions in LINE, automating responses to messages, and integrating LINE messaging capabilities into larger applications.

How to use

To use py-mcp-line, clone the repository from GitHub, navigate to the project directory, and install the required Python packages using pip. Configure the environment variables as needed and run the server to handle LINE Bot messages.

Key features

Key features include asynchronous operation with Python’s asyncio, environment-based configuration, comprehensive logging, LINE Bot webhook event handling, JSON message storage, FastAPI integration for API endpoints, Pydantic models for data validation, and support for text, sticker, and image messages.

Where to use

py-mcp-line can be used in applications that require interaction with LINE messaging services, such as chatbots, customer support systems, and any service that needs to analyze or respond to LINE conversations.

Python LINE MCP Server

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

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
│   └── test_line.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
  • test_line.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:

LINE_CHANNEL_SECRET=your_channel_secret
LINE_ACCESS_TOKEN=your_access_token
SERVER_PORT=8000
MESSAGES_FILE=data/messages.json

API Implementation Details

Resource Listing

@app.list_resources()
async def list_resources() -> list[Resource]

• Lists available message types from the LINE Bot
• Returns resources with URIs in the format line://<message_type>/data
• Includes resource descriptions and MIME types

Resource Reading

@app.read_resource()
async def read_resource(uri: AnyUrl) -> str

• Reads messages of the specified type
• Accepts URIs in the format line://<message_type>/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/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "line": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "LINE_CHANNEL_SECRET": "your_channel_secret",
        "LINE_ACCESS_TOKEN": "your_access_token",
        "SERVER_PORT": "8000",
        "MESSAGES_FILE": "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.

Security Features

• Environment variable based configuration
• LINE message signature validation
• Proper error handling
• Input validation through Pydantic

Contact Information

Amornpan Phornchaicharoen

Feel free to reach out to me if you have any questions about this project or would like to collaborate!

---

Made with ❤️ by Amornpan Phornchaicharoen

Author

Amornpan Phornchaicharoen

Requirements

Create a requirements.txt file with:

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

These versions have been tested and verified to work together. The key components are:

• fastapi and uvicorn for the API server
• pydantic for data validation
• line-bot-sdk for LINE Bot integration
• mcp for Model Context Protocol implementation
• python-dotenv for environment configuration
• anyio for asynchronous I/O support

Acknowledgments

• LINE Developers for the LINE Messaging API
• Model Context Protocol community
• Python FastAPI community
• Contributors to the python-dotenv project