Python Line Server

🚀 Python LINE MCP Server

A Model Context Protocol (MCP) server implemented in Python, providing access to LINE bot messages. This server enables language models to read and analyze LINE conversations through a standardized interface.

🚀 Quick Start

This is a Model Context Protocol (MCP) server implemented in Python, offering access to LINE bot messages. The server allows language models to read and analyze LINE conversations via a standardized interface.

✨ Features

Core Features

• Asynchronous operations using Python's asyncio
• Environment configuration with python-dotenv
• Compliant with Model Context Protocol 1.2.0
• Integration of LINE Messaging API
• Provision of RESTful API interfaces

📋 Prerequisites

The following components need to be installed and configured:

• Python 3.8+
• FastAPI 0.104.1 or higher
• Uvicorn 0.34.0 or higher
• Pydantic 2.10.6 or higher
• LINE Bot SDK 3.5.0 or higher

📦 Installation

Create a requirements.txt file with the following content:

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

Run the following command to install the dependencies:

pip install -r requirements.txt

📁 Project Structure

The following is the folder and file structure of the project:

your_project/
├── app/                       # FastAPI application code
│   ├── main.py               # FastAPI application entry point
│   └── routes/               # Route definitions
│       └── line_mcp.py      # LINE MCP routes
├── config/                   # Configuration files
│   ├── .env                 # Environment variable configuration
│   └── mcp_config.yml       # MCP configuration
└── utils/                    # Utility functions
    └── line_bot_utils.py     # LINE bot utilities

⚙️ Configuration

Create a .env file with the following content:

# Production mode configuration (recommended)
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

# Or development mode:
IS_PRODUCTION=false
LINE_CHANNEL_ID=your_channel_id
LINE_CHANNEL_SECRET=your_channel_secret

Replace your_channel_id and your_channel_secret with your LINE bot credentials.

💻 Usage Examples

Basic Usage

Initialize the server:

uvicorn app.main:app --reload

Access the interfaces:

• List all resources: curl http://localhost:8000/mcp/resources
• Get a specific resource: curl http://localhost:8000/mcp/resources/{id}

API Implementation Details

Resource Listing Interface

@app.get("/mcp/resources")
def list_resources():
    # Get all resource information
    resources = get_all_resources()
    return {"status": "success", "data": resources}

Resource Reading Interface

@app.get("/mcp/resources/{resource_id}")
def read_resource(resource_id: str):
    # Read the content of a specific resource
    resource_content = fetch_resource_by_id(resource_id)
    return {"status": "success", "data": resource_content}

Resource Creation Interface

@app.post("/mcp/resources")
def create_resource(resource_data: ResourceData):
    # Create a new resource
    new_resource = create_new_resource(resource_data)
    return {"status": "success", "data": new_resource}

🛠️ Error Handling

The server includes a comprehensive error handling mechanism, including:

• Parameter validation
• Resource non-existence exceptions
• Permission checks
• Network connection exceptions

🔒 Security Features

The following security measures are supported:

• Environment variable configuration
• Access Control List (ACL)
• Logging and monitoring
• Encrypted data transmission

📞 Contact

Amornpan Phornchaicharoen

If you have any questions or cooperation intentions, please feel free to contact me.

⚠️ Important Note

This project is open source under the MIT license. Please read the relevant documentation and the LICENSE file carefully before use.