Medium MCP Api

🚀 Chinese MCP Server Documentation

The Medium Control Panel (MCP) server is a platform for managing content publishing and distribution. It offers features for creating, editing, publishing, and scheduling articles, and supports integration into other systems via API.

🚀 Quick Start

The Medium MCP (Medium Control Panel) server is a platform for managing content publishing and distribution. It provides functions for creating, editing, publishing, and scheduling articles, and supports integration into other systems through APIs.

📦 Installation

Quick Installation

1. Clone the repository:

git clone git@github.com:your-repo/mcp-server.git

2. Install dependencies:

npm install

3. Start the server:

node index.js

Configuration

All configurations are done via environment variables. You need to set the following parameters in the .env file:

💻 Usage Examples

Create and Publish Articles

Create a Draft

const axios = require('axios');

async function createDraft() {
  try {
    const response = await axios.post('http://localhost:3000/api/posts', {
      title: 'My First Article',
      content: '# Welcome to the MCP Server\nThis is my first article published via API.',
      contentFormat: 'markdown',
      tags: ['MCP', 'Tutorial', 'API'],
      publishStatus: 'draft'
    }, {
      headers: {
        'Authorization': `Bearer ${TOKEN}`
      }
    });
    
    console.log('Draft created successfully:', response.data);
  } catch (error) {
    console.error('Failed to create draft:', error.response?.data || error.message);
  }
}

createDraft();

Publish an Article

async function publishArticle(postId) {
  try {
    const response = await axios.post(`http://localhost:3000/api/posts/${postId}/publish`, {}, {
      headers: {
        'Authorization': `Bearer ${TOKEN}`
      }
    });
    
    console.log('Article published:', response.data);
  } catch (error) {
    console.error('Failed to publish:', error.response?.data || error.message);
  }
}

// Example call
publishArticle('647f5d3b0c87e5a9c23b1aa1');

Get Article List

async function listArticles(status = 'all', page = 1, limit = 10) {
  try {
    const response = await axios.get(`http://localhost:3000/api/posts?status=${status}&page=${page}&limit=${limit}`, {
      headers: {
        'Authorization': `Bearer ${TOKEN}`
      }
    });
    
    console.log('Article list:', response.data);
  } catch (error) {
    console.error('Failed to get articles:', error.response?.data || error.message);
  }
}

// Example call
listArticles('draft', 1, 20);

Scheduled Publishing

It supports scheduling future article publishing times by setting the scheduledAt attribute. For example:

const scheduledPost = {
  title: 'Tomorrow\'s Article',
  content: '# See you tomorrow\nThis is a scheduled post.',
  publishStatus: 'draft',
  scheduledAt: '2023-10-10T15:00:00Z'
};

async function scheduleArticle() {
  try {
    const response = await axios.post('http://localhost:3000/api/posts', scheduledPost, {
      headers: {
        'Authorization': `Bearer ${TOKEN}`
      }
    });
    
    console.log('Article scheduled:', response.data);
  } catch (error) {
    console.error('Failed to schedule:', error.response?.data || error.message);
  }
}

scheduleArticle();

📚 Documentation

Security Guide

JWT Authentication

All authenticated API requests require the Authorization field to be added to the header in the following format:

Bearer <your-jwt-token>

Secret Management

Ensure that JWT_SECRET and other sensitive configurations are not leaked. It is recommended to use environment variables or secret management tools to store this information.

Error Handling

Common Error Codes

Deprecation Warnings

Some old API interfaces may be deprecated. It is recommended to update to the latest version.

Development Guide

Contribute Code

1. Before submitting code, ensure that all tests pass.
2. Follow the project's coding standards.
3. When submitting a PR, include detailed change descriptions.

Use Docker

# Dockerfile
FROM node:16-alpine

WORKDIR /app

COPY package*.json ./

RUN npm install --production

COPY . .

CMD ["node", "index.js"]

Contact Us

If you need feedback or technical support, please visit our GitHub repository or send an email to support@yourdomain.com.

Thank you for using the MCP server!