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 サーバーをご利用いただき、誠にありがとうございます。