Medium MCP Api

🚀 中文 MCP 服務器文檔

中型 MCP（Medium Control Panel）服務器是一個用於管理內容發佈和分發的平臺。它提供了創建、編輯、發佈和調度文章的功能，還支持通過 API 集成到其他系統，為內容管理帶來便利。

🚀 快速開始

本部分將為你介紹如何快速搭建 MCP 服務器，讓你能儘快使用其功能。

📦 安裝指南

快速安裝

按以下步驟快速完成服務器的安裝：

1. 克隆倉庫：

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

2. 安裝依賴項：

npm install

3. 啟動服務器：

node index.js

配置

所有配置通過環境變量完成，你需要在 .env 文件中設置以下參數：

💻 使用示例

基礎用法

創建草稿

const axios = require('axios');

async function createDraft() {
  try {
    const response = await axios.post('http://localhost:3000/api/posts', {
      title: '我的第一篇文章',
      content: '# 歡迎使用 MCP 服務器\n這是我的第一篇通過 API 發佈的文章。',
      contentFormat: 'markdown',
      tags: ['MCP', '教程', 'API'],
      publishStatus: 'draft'
    }, {
      headers: {
        'Authorization': `Bearer ${TOKEN}`
      }
    });
    
    console.log('草稿創建成功:', response.data);
  } catch (error) {
    console.error('創建草稿失敗:', error.response?.data || error.message);
  }
}

createDraft();

發佈文章

async function publishArticle(postId) {
  try {
    const response = await axios.post(`http://localhost:3000/api/posts/${postId}/publish`, {}, {
      headers: {
        'Authorization': `Bearer ${TOKEN}`
      }
    });
    
    console.log('文章已發佈:', response.data);
  } catch (error) {
    console.error('發佈失敗:', error.response?.data || error.message);
  }
}

// 調用示例
publishArticle('647f5d3b0c87e5a9c23b1aa1');

獲取文章列表

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('文章列表:', response.data);
  } catch (error) {
    console.error('獲取文章失敗:', error.response?.data || error.message);
  }
}

// 示例調用
listArticles('draft', 1, 20);

高級用法

調度發佈

支持通過設置 scheduledAt 屬性來調度未來的文章發佈時間。例如：

const scheduledPost = {
  title: '明天的文章',
  content: '# 明天見\n這是一篇預定發佈的內容。',
  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('文章已調度:', response.data);
  } catch (error) {
    console.error('調度失敗:', error.response?.data || error.message);
  }
}

scheduleArticle();

📚 詳細文檔

安全指南

JWT 認證

所有需要認證的 API 請求都需要在頭中添加 Authorization 字段，格式如下：

Bearer <your-jwt-token>

密鑰管理

確保 JWT_SECRET 和其他敏感配置不被洩露。建議使用環境變量或密鑰管理工具來存儲這些信息。

錯誤處理

常見錯誤代碼

棄用警告

某些舊的 API 接口可能已棄用，建議更新到最新版本。

開發指南

貢獻代碼

1. 提交代碼前，請確保通過所有測試。
2. 遵循項目編碼規範。
3. 提交 PR 時請附帶詳細的變更說明。

使用 Docker

# Dockerfile
FROM node:16-alpine

WORKDIR /app

COPY package*.json ./

RUN npm install --production

COPY . .

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

聯繫我們

如需反饋或技術支持，請訪問我們的 GitHub 倉庫 或發送郵件至 support@yourdomain.com。

感謝使用 MCP 服務器！