Writeathon MCP Server

🚀 Writeathon MCP Server

A Writeathon API server based on the MCP protocol, offering MCP services integrated with the Writeathon platform.

🚀 Quick Start

This server provides seamless integration with the Writeathon platform through the MCP protocol. It offers both REST API and MCP service interfaces to meet various needs.

✨ Features

• Developed with Node.js and TypeScript.
• Provides services using the MCP (Model Context Protocol).
• Fully supports all features of the Writeathon API.
• Offers both REST API and MCP service interfaces.

📦 Installation

# Ensure Node.js 20 is used
nvm use 20

# Install dependencies
npm install

📚 Configuration

1. Copy the .env.example file to .env.
2. Edit the .env file and fill in your Writeathon user ID, integration token (obtained in Writeathon → Settings → Integration), and MCP API key.

# API configuration
API_BASE_URL=https://api.writeathon.cn
WRITEATHON_USER_ID=your_user_id_here
WRITEATHON_TOKEN=your_integration_token_here

# Server configuration
PORT=3000
HOST=localhost

# MCP configuration
MCP_API_KEY=your_mcp_api_key_here

💻 Usage Examples

Basic Usage

# Run in development mode
npm run dev

# Or build and run
npm run build
npm start

• The server will run on HOST:PORT.
• The MCP service will run on HOST:PORT+1.
• The MCP SSE address is HOST:PORT+1/mcp/sse.

📚 Documentation

REST API Interfaces

The server provides the following REST API interfaces:

• GET /api/me - Get user information.
• POST /api/cards - Create a card.
• GET /api/cards/recent - Get a list of recently updated cards.
• POST /api/cards/get - Get a card.
• POST /api/writing-pick - Writing pick.

MCP Services

The server provides the following MCP services:

• me - Get user information.
• create_card - Create a card.
• recent_cards - Get a list of recently updated cards.
• get_card - Get a card.
• writing_pick - Writing pick.

📄 License

ISC