SharePoint MCP サーバー

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

特徴

このサーバーは、モデル コンテキスト プロトコル (MCP) を通じて SharePoint リソースへのクリーンなインターフェイスを提供し、ドキュメント管理用に最適化された操作を提供します。

ツール

サーバーは次のツールを実装します。

• List_SharePoint_Folders : 指定されたディレクトリまたはルート内のすべてのフォルダを一覧表示します

• List_SharePoint_Documents : 指定されたフォルダ内のすべてのドキュメントを取得します

• Get_Document_Content : ドキュメントのコンテンツを取得します（テキストまたはbase64エンコードされたバイナリとして）

• Create_Folder : 指定されたディレクトリまたはルートに新しいフォルダを作成します

• Upload_Document : 指定されたフォルダに新しいドキュメントをアップロードします

• Upload_Document : パスから大きなドキュメントをアップロードします。

• Update_Document : 既存のドキュメントの内容を更新します

• Delete_Document : 指定されたフォルダからドキュメントを削除します

• Delete_Folder : SharePoint から空のフォルダーを削除します

Related MCP server: MCP Server

建築

サーバーはリソース効率を考慮して構築されています。

• 選択的なプロパティの読み込みによる SharePoint API の効率的な使用

• デコレータによるエラー処理でよりきれいなコードを実現

• リソース管理とツール実装の明確な分離

• テキストファイルとバイナリファイルの両方に対して最適化されたコンテンツ処理

設定

1. 適切な SharePoint 権限を使用して Azure AD にアプリを登録する

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 Desktop と統合するには、構成ファイルを更新します。

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": "Shared Documents/your-folder",
      "SHP_TENANT_ID": "your-tenant-id"
    }
  }
}

uvxの使用

"mcpServers": {
  "sharepoint": {
    "command": "uvx",
    "args": [
      "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": "Shared Documents/your-folder",
      "SHP_TENANT_ID": "your-tenant-id"
    }
  }
}

発達

要件

• Python 3.10以上

• requirements.txtとpyproject.tomlにリストされている依存関係

地域開発

1. リポジトリをクローンする

2. 仮想環境を作成します。

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. 開発依存関係をインストールします。

   pip install -e .

4. 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=Shared Documents/your-folder
   SHP_TENANT_ID=your-tenant-id

5. サーバーを実行します。

   python -m mcp_sharepoint

デバッグ

MCP サーバーをデバッグするには、 MCP Inspector を使用できます。

npx @modelcontextprotocol/inspector -- python -m mcp_sharepoint

ライセンス

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

Copyright (c) 2025 ソフィアステック