Email MCP Server Simple

🚀 MCP Server Collection

This repository hosts five Model Context Protocol (MCP) servers that you can integrate into the Claude desktop version.

🚀 Quick Start

1. line-bot (in a separate terminal)

git clone https://github.com/iamkaia/email-mcp-server-simple.git
cd email-mcp-server-simple

## Set up the Python environment and install the required dependencies (only for _email_mcp_)
python -m venv .venv
source .venv/bin/activate      # Windows: .\.venv\Scripts\activate
pip install -r requirements.txt

### Fill in the `.env` file** (only for `email_mcp`, do not commit):
# SMTP
SMTP_SERVER=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=you@example.com
SMTP_PASSWORD=your_smtp_password

# IMAP
IMAP_SERVER=imap.example.com
IMAP_PORT=993
IMAP_USERNAME=you@example.com
IMAP_PASSWORD=your_imap_password

## Start the server
uvicorn main:app --reload --host 0.0.0.0 --port 8000

2. line-bot-mcp (in a separate terminal)

# Clone the repository
git clone git@github.com:line/line-bot-mcp-server.git
cd line-bot-mcp-server && npm install && npm run build

3. fetch (in a separate terminal)

pip install mcp-server-fetch
python -m mcp_server_fetch

4. Word-MCP-Server (in a separate terminal)

# Clone the repository
git clone https://github.com/YOUR-REPO.git
cd word-mcp-server
npm install
node server.js

5. filesystem (in a separate terminal)

# Clone the repository
git clone https://github.com/YOUR-REPO.git
cd filesystem-mcp-server
pip install -r requirements.txt
python -m app.main

📦 Server Configuration Example

Add the following content to config.json:

{
  "servers": [
    {
      "name": "line-bot",
      "url": "http://localhost:8000"
    },
    {
      "name": "email-mcp",
      "url": "http://localhost:9000"
    },
    {
      "name": "fetch",
      "url": "http://localhost:10000"
    },
    {
      "name": "word-document-service",
      "url": "http://localhost:11000"
    },
    {
      "name": "filesystem",
      "url": "http://localhost:12000"
    }
  ]
}

✨ Features

Detailed tool list tools.md

💻 Usage Examples

Example JSON-RPC Calls (for reference only)

// Send an email
{
  "tool":"send_email",
  "input":{"params":{
    "to":["friend@example.com"],
    "subject":"Hello",
    "body":"This is a test.",
    "html":false
  }}
}

// List recent emails
{
  "tool":"list_recent_emails",
  "input":{"params":{
    "limit":3
  }}
}

// Fetch a web page
{
  "tool":"fetch_page",
  "input":{"params":{"url":"https://example.com"}}
}

// Create a Word document
{
  "tool":"create_document",