Arcs MCP

🚀 Arcs-MCPへようこそ👋

このツールは、文章を複数のプラットフォームにシェアして公開する際の流れを簡素化します。MCPサービスをサポートしており、自然言語で操作し、複数のプラットフォームへの一括公開を実現します。

🚀 クイックスタート

このセクションでは、Arcs-MCPを使用するための基本的な手順を説明します。まずは、必要な環境をセットアップし、ツールをインストールして構成しましょう。

✨ 主な機能

• 複数のプラットフォームへの文章の一括公開をサポート。
• 自然言語による操作で、簡単に文章を指定のプラットフォームに公開できる。
• 各プラットフォームの公開インターフェースと自動化技術を統合し、効率的な公開を実現。
• 外部リンクの画像をプラットフォームに互換性のある画像リンクに自動変換。
• 公開操作のwebページを提供し、ブラウザでの操作が可能。

📦 インストール

🔑 前提条件

• MCPに対応したAIクライアント：Claudeデスクトップ版、Gemini CLI、Cherry Studioまたはその他のMCPクライアント。
• uv：最新のPythonパッケージインストーラーと解析器。

1. uv環境のインストール

Cherry Studio クライアントを使用して、このツールのMCPサービスを構成することをおすすめします。操作と環境構成がより使いやすくなります。Cherry Studioにはuv環境のデプロイ機能も付属しており、ワンクリックでインストールを完了できます。

⚠️ 重要提示

Cherry Studioは現在、組み込みの uv と bun のみを使用し、システムに既にインストールされているuvとbunは再利用しません。

uv環境を手動で個別にインストールすることもできます。コマンドラインを使用してデプロイを完了します。

macOS & Linux

# `curl` を使用してスクリプトをダウンロードし、`sh` で実行します。
curl -LsSf https://astral.sh/uv/install.sh | sh

# システムに `curl` がない場合は、`wget` を使用できます。
wget -qO- https://astral.sh/uv/install.sh | sh

Windows

# `irm` を使用してスクリプトをダウンロードし、`iex` で実行します。
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. リポジトリのクローン

1. リポジトリをクローンし、ディレクトリに移動します。

git clone https://github.com/Cyanty/Arcs-MCP.git
cd Arcs-MCP

2. 環境構成ファイルをコピーします。

cp .env.example .env

💡 使用建议

一部のプラットフォームはAPIによる記事の公開をサポートしており、.envファイルを使用して必要なプラットフォームのキーを構成できます。

3. サービスを構築して実行します。

uv run --directory your/path/to/Arcs-MCP server.py

3. MCPクライアントの構成

MCPクライアントを構成します。ここでは、Cherry Studio のAIクライアントツールを例に説明します。

• サーバーの追加 ボタンをクリックし、クイック作成 オプションを選択します。ストリーミング可能なHTTP (streamableHttp) タイプ を選択し、以下のURLを追加します。

http://127.0.0.1:8001/submit/mcp

クイック作成 の構成は次のようになります。

または、JSON構成を使用することもできます。

• サーバーの追加 ボタンをクリックし、JSONからインポート オプションを選択します。以下の内容を構成ファイルに追加します。

{
  "mcpServers": {
    "SubmitArticleServer": {
      "type": "streamableHttp",
      "url": "http://localhost:8001/submit/mcp"
    }
  }
}

💻 使用例

利用可能なツール

利用可能なツールの一覧を以下に示します。

ツールの説明：

• help_open_browser：ユーザーが一度だけブラウザ（MCP公開ブラウザ）を開くのを支援します。例："ブラウザを開いてください"。ユーザーはこのブラウザを使用してアカウントログインなどの操作を行うことができます。
• submit_verify_login：すべての公開元プラットフォームのアカウントログイン状態を確認します。例："すべてのプラットフォームのログイン状態を確認してください"。ユーザーはこの方法で各プラットフォームのアカウントログイン状態と個人のトークン/キーが有効かどうかを確認できます。
• get_submit_toggle_switch：現在の各公開元の公開スイッチの状態を取得します。例："現在の各プラットフォームの公開スイッチの状態を教えてください"。公開スイッチは、ユーザーにどのプラットフォームで記事を公開できるかを示します。
• update_submit_toggle_switch：各公開元プラットフォームの公開スイッチの状態を更新します。例："CSDNプラットフォームの公開スイッチをオンにしてください"。プラットフォームの公開スイッチをオンにすると、指定のプラットフォームに記事を公開できます。
• submit_article_content_prompt：記事のテキスト内容を各プラットフォームに公開します。例："この記事のテキスト内容をCSDNに公開してください"。公開操作が完了すると、公開したプラットフォームで自分の記事を見ることができます。
• submit_article_file_to_platforms：記事のファイルパスを指定して各プラットフォームに公開します。例："/your/path/to/file-absolute-path の記事をCSDNに公開してください"。公開操作が完了すると、公開したプラットフォームで自分の記事を見ることができます。

記事の公開例

💡 使用建议

公開する前に、MCP公開ブラウザと個人のトークン/キーがログインまたは使用可能な状態であることを確認してください。

Cherry Studio を使用して、チャット形式で記事をCSDNに公開する方法を説明します。

新しいチャットウィンドウを開き、MCPサーバーをクリックし、前に構成した SubmitArticleServer MCPサービスを選択します。

チャットボックスに、例えば "この記事をCSDNに公開してください。記事のローカルパスは：C:\Users\Administrator\Desktop\記事公開テスト.md" と入力し、大規模モデルからの公開結果を待ちます。

この公開ツールは、テキスト内容での公開もサポートしていますが、統合されたAIクライアントツールの処理方法によっては、大規模モデルが記事の全内容をコンテキストとして読み取り、Tokenを大量に消費し、時間もかかります。ここでは、ファイルパスでの公開 をおすすめします。

テキスト内容での公開のチャット入力例は次の通りです。

🔧 技術詳細

この公開ツールはMCPサービスをサポートし、各プラットフォームの公開インターフェースと自動化技術を統合して、効率的な公開を実現します。

• 統一されたエントリー：.mdファイルから直接内容をインポートすることをサポートし、MCPサービスに適合して非同期並列公開を実現。
• 画像処理：外部リンクの画像をプラットフォームに互換性のある画像リンクに自動変換。
• 公開方法：各プラットフォームの特性に応じて、API呼び出しまたはブラウザ自動化の2つの戦略を採用。

現在サポートされている公開プラットフォーム（他のプラットフォームを横方向に拡張することも可能）

また、このツールは公開操作のwebページを提供しており、ユーザーはブラウザページで操作し、ローカルの.md形式のファイルをアップロードして各プラットフォームへの記事公開を行うことができます。

例えば、http://127.0.0.1:8001 にアクセスすると、公開ページが表示されます。

🤝 貢献の歓迎

貢献を歓迎します！バグの修正、新機能の追加、またはドキュメントの改善など、何でもPull Requestを送信したり、issueを開いたりしてください。

📄 ライセンス

このプロジェクトは Apache License 2.0 に従っています。詳細は LICENSE ファイルを参照してください。