MCP Sharepoint

🚀 Microsoft SharePoint MCP サーバー

軽量なMCPサーバーで、Microsoft SharePointとのシームレスな統合を実現し、MCPクライアントがドキュメント、フォルダー、その他のSharePointリソースと相互作用できるようにします。sofias techによって開発されました。

✨ 主な機能

このサーバーは、Model Context Protocol (MCP) を通じてSharePointリソースへのクリーンなインターフェースを提供し、ドキュメント管理に最適化された操作を行います。

ツール

このサーバーは以下のツールを実装しています：

• List_SharePoint_Folders：指定されたディレクトリまたはルートディレクトリ内のすべてのフォルダーをリストします。
• List_SharePoint_Documents：指定されたフォルダー内のすべてのドキュメントを取得します。
• Get_Document_Content：ドキュメントの内容を（テキストまたはBase64エンコードされたバイナリとして）取得します。
• Create_Folder：指定されたディレクトリまたはルートディレクトリ内に新しいフォルダーを作成します。
• Upload_Document：指定されたフォルダーに新しいドキュメントをアップロードします。
• Update_Document：既存のドキュメントの内容を更新します。
• Delete_Document：指定されたフォルダーからドキュメントを削除します。
• Delete_Folder：空のSharePointフォルダーを削除します。

🔧 技術詳細

このサーバーは、リソース効率を重視して設計されています：

• 選択的な属性ロードにより、SharePoint APIを効率的に使用します。
• デコレータを使用してクリーンなエラー処理を実装します。
• リソース管理とツール実装を明確に分離します。
• テキストおよびバイナリファイルの内容処理を最適化しています。

📦 インストール

セットアップ

1. Azure ADで適切なSharePointアクセス許可を持つアプリケーションを登録します。
2. 登録したアプリのクライアントIDとクライアントシークレットを取得します。
3. あなたのSharePointサイトURLと操作対象のドキュメントライブラリのパスを特定します。

環境変数

サーバーには以下の環境変数が必要です：

• SHP_ID_APP：あなたのAzure ADアプリケーションのクライアントID
• SHP_ID_APP_SECRET：あなたのAzure ADアプリケーションのクライアントシークレット
• SHP_SITE_URL：あなたのSharePointサイトのURL
• SHP_DOC_LIBRARY：ドキュメントライブラリのパス（デフォルト: "Shared Documents/mcp_server"）
• SHP_TENANT_ID：あなたのMicrosoftテナントID

インストールコマンド

pip install -e .

または、PyPIに公開された後は以下のコマンドでインストールできます：

pip install mcp-sharepoint-server

uvを使用する場合：

uv pip install mcp-sharepoint-server

Claudeデスクトップとの統合

Claudeデスクトップと統合するには、設定ファイルを更新します：

Windowsの場合: %APPDATA%/Claude/claude_desktop_config.json macOSの場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json

標準的な統合

"mcpServers": {
  "sharepoint": {
    "command": "mcp-sharepoint",
    "env": {
      "SHP_ID_APP": "your-app-id",
      "SHP_ID_APP_SECRET": "your-app-secret",
      "SHP_SITE_URL": "https://your-tenant.sharepoint.com/sites/your-site",
      "SHP_DOC_LIBRARY": "Documents"
    }
  }
}

高度な設定

以下の環境変数を使用して追加の設定を行うこともできます：

• SHP_API_VERSION：使用するSharePoint APIのバージョンを指定します（デフォルト: "v1.0"）
• SHP_AUTH_TYPE：認証タイプを指定します（"AzureAD"と"Guest"をサポート、デフォルト: "AzureAD"）

開発環境のセットアップ

依存関係のインストール

pip install -r requirements.txt

ローカル開発

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/mcp-sharepoint.git
   cd mcp-sharepoint
   

2. 上記の手順で依存関係をインストールします。
3. サーバーを起動します：

   python -m mcp_sharepoint
   

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

Copyright (c) 2025 sofias tech