pshare-share-mcp

MCPサーバーは、あらゆるAI（Claude Code、Claude Desktop、その他のMCPクライアント）がファイル/フォルダーをPshareにアップロードし、共有リンクを受け取れるようにします。UIからアップロードして共有ボタンを押してリンクをコピーする手動操作とまったく同じです。

ログインやトークンは一切不要です。Pshareの現在のアーキテクチャと一貫しています（Webクライアント自体も実際には認証を行わず、自動生成されたX-Browser-Idのみを使用します）。

要件: Pshare のインスタンスがどこか（localhostまたはLAN内）で実行されている必要があります。このリポジトリはPshareのREST APIを呼び出すMCPサーバーであり、Pshare自体を実行するものではありません。

提供ツール

pshare_upload

返される結果: http://<pshare-host>/?share=<N> 形式の共有リンクと、ファイル数とパスワードステータス。

90MBを超えるファイルは自動的にチャンクアップロード（WebクライアントのLANアップロード動作と同様）に切り替わります。追加の操作は不要です。

Related MCP server: SharePoint MCP Server

インストール

このリポジトリをクローンするだけです。Pshare全体をダウンロードする必要はありません:

git clone https://github.com/ntanhprt/Pshare-mcp.git
cd Pshare-mcp
pnpm install
pnpm build      # biên dịch ra dist/

設定（環境変数）

localhost は、MCPサーバーがPshareを実行しているのと同じマシンで実行されている場合にのみ正しく機能します。 localhost は常に「そのプロセスを実行しているマシン自身」を指すため、Pshareを実行しているマシンとは異なるマシン/ラップトップ（同じLAN内であっても）にこのMCPをインストールする場合は、Pshareを実行しているマシンの実際のIPアドレスに変更する必要があります。たとえば、PshareがIP 192.168.3.7 のマシンで実行されている場合:

PSHARE_BASE_URL=http://192.168.3.7:5173 claude mcp add pshare-share -- node "$(pwd)/dist/index.js"

localhost のデフォルトは、Pshareを実行しているのと同じマシンでMCP（stdio）を実行する場合にのみ保持してください。

単体で試す

# stdio (mặc định)
pnpm start

# HTTP/SSE — AI ở máy khác trong LAN cũng gọi được
pnpm start:http
# → nghe tại http://<PSHARE_MCP_HOST>:<PSHARE_MCP_PORT>/mcp

他の開発者向け統合ガイド

1. Claude Codeで使用する（stdioトランスポート — AIがPshareと同じマシン/ホストで実行される場合に推奨）

クローンしてビルドした後（上記のインストールセクションを参照）、Pshare-mcp ディレクトリ内から:

claude mcp add pshare-share -- node "$(pwd)/dist/index.js"

別のマシンでPshareを指定するには、-e でenvを渡します（設定セクションの localhost に関する注意を参照）:

claude mcp add pshare-share \
  -e PSHARE_BASE_URL=http://192.168.3.7:5173 \
  -- node "$(pwd)/dist/index.js"

登録されているか確認:

claude mcp list

2. Claude Desktopで使用する（stdioトランスポート）

設定ファイル（macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは %APPDATA%\Claude\claude_desktop_config.json）を開き、次を追加します:

{
  "mcpServers": {
    "pshare-share": {
      "command": "node",
      "args": ["/đường/dẫn/tuyệt/đối/tới/Pshare-mcp/dist/index.js"],
      "env": {
        "PSHARE_BASE_URL": "http://localhost:5173"
      }
    }
  }
}

Claude Desktopを再起動して、pshare_upload ツールを認識させます。

3. HTTP/SSE経由で使用する（AIが同じLAN内の別のマシンで実行されている場合）

Pshareをホストしているマシン（またはPshareに到達できる任意のマシン）でMCPサーバーを実行します:

PSHARE_BASE_URL=http://localhost:5173 pnpm start:http

クライアントマシン（Claude Code、またはHTTPトランスポートをサポートするMCPクライアント）で、次を指定します:

http://<IP-máy-chạy-mcp>:7317/mcp

Claude Codeの例:

claude mcp add --transport http pshare-share http://192.168.3.7:7317/mcp

4. その他のAI/エージェントフレームワークで使用する

MCPは標準のJSON-RPCプロトコルです。任意のMCPクライアント（LangChain MCPアダプター、カスタムエージェントなど）から接続できます。必要なのは次のとおりです:

• stdio: node dist/index.js コマンドを起動し、stdin/stdoutを介して通信します。

• HTTP: MCPのStreamable HTTPトランスポート仕様に従って POST http://<host>:<port>/mcp を呼び出します。

セキュリティ上の注意

このMCPサーバーは認証を行いません。アクセスできれば（プロセス実行権限があればstdio経由、またはホスト:ポートにアクセスできればHTTP経由で）、誰でも実際のPshareにファイルをアップロード/共有できます。これはPshare自体（アップロード/共有APIに認証がない）と一貫していますが、HTTPトランスポートをLANに公開する場合は注意が必要です。