Sharepoint MCP Nodejs

SharePoint MCP服务器

用于通过Microsoft Graph API管理SharePoint文件和文件夹的TypeScript MCP（模型上下文协议）服务器。

特性

• 11个MCP工具 用于完整的SharePoint文件/文件夹管理
• 两个身份验证流：客户端凭据（应用程序级别）和代表（用户级别）
• 两次运输：stdio（用于克劳德桌面/CLI）和流式HTTP
• 可恢复上传 用于大文件（>4MB）
• 内容提取 来自PDF、Word（.docx）、Excel（.xlsx）和文本文件
• Markdown到DOCX的转换 通过Pandoc使用SharePoint中的可选样式模板

快速开始

1.安装依赖项

npm install
npm run build

2.配置环境

cp .env.example .env
# Edit .env with your Azure AD and SharePoint details

所需的环境变量：

• AZURE_TENANT_ID -Azure AD租户ID
• AZURE_CLIENT_ID -应用注册客户端ID
• AZURE_CLIENT_SECRET -应用注册客户端密码
• SHAREPOINT_HOSTNAME -例如。 yourcompany.sharepoint.com
• SHAREPOINT_SITE_NAME -例如。 YourSiteName
• AUTH_FLOW - client_credentials （默认）或 on_behalf_of

3.跑步

stdio传输 （适用于克劳德桌面）：

npm start

HTTP传输:

npm run start:http
# Server starts on http://localhost:3000/mcp

Claude桌面配置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sharepoint": {
      "command": "node",
      "args": ["/path/to/sharepoint-mcp-nodejs/dist/index.js"],
      "env": {
        "AZURE_TENANT_ID": "your-tenant-id",
        "AZURE_CLIENT_ID": "your-client-id",
        "AZURE_CLIENT_SECRET": "your-client-secret",
        "SHAREPOINT_HOSTNAME": "yourcompany.sharepoint.com",
        "SHAREPOINT_SITE_NAME": "YourSiteName"
      }
    }
  }
}

可用工具

Markdown到DOCX的转换

这 Create_Document_From_Markdown 该工具使用以下命令将markdown或纯文本转换为.docx文件 潘多克。 并将其上传到SharePoint。

参数：

• content （必填）--要转换的Markdown或纯文本
• folder_path （必需）--SharePoint中的目标文件夹
• file_name （必填）--输出文件名（例如。 report.docx)
• template_path （可选）--SharePoint上用于样式设置的.docx模板的路径

样式模板： 在Word中创建一个具有所需样式（字体、标题、边距、颜色）的.docx文件，将其上传到SharePoint，然后将其引用为 template_path.Pandoc通过以下方式将模板中的样式应用于生成的文档 --reference-doc.

测试Markdown到DOCX工具

先决条件： 必须安装Pandoc。在Docker中，这是自动处理的。对于当地发展：

# macOS
brew install pandoc

# Ubuntu/Debian
sudo apt-get install pandoc

# Verify
pandoc --version

测试1——基本转换（无模板）：

使用MCP检查器：

npx @modelcontextprotocol/inspector node dist/index.js

呼叫 Create_Document_From_Markdown 与：

{
  "content": "# My Report\n\n## Introduction\n\nThis is a **test** document with:\n\n- Bullet point 1\n- Bullet point 2\n\n## Data\n\n| Name | Value |\n|------|-------|\n| A    | 100   |\n| B    | 200   |",
  "folder_path": "Shared Documents",
  "file_name": "test-report.docx"
}

然后验证 Get_Document_Content:

{
  "file_path": "Shared Documents/test-report.docx"
}

测试2——使用样式模板：

1. 在Word中创建一个样式化的.docx模板（设置字体、标题样式、边距、颜色）
2. 上传到SharePoint（例如通过 Upload_Document_From_Path 或手动）
3. 呼叫 Create_Document_From_Markdown 使用模板：

{
  "content": "# Styled Report\n\nThis document uses corporate styling.",
  "folder_path": "Shared Documents",
  "file_name": "styled-report.docx",
  "template_path": "Templates/corporate-style.docx"
}

测试3——通过curl（HTTP传输）：

# Initialize session
curl -s -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"0.1.0"}}}'

# Call the tool (use the mcp-session-id from the response headers above)
curl -s -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "mcp-session-id: " \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"Create_Document_From_Markdown","arguments":{"content":"# Hello World\n\nTest document.","folder_path":"Shared Documents","file_name":"curl-test.docx"}}}'

上传策略

• **文件\` 头球

看 docs/azure setup.md 有关详细的Azure门户设置说明。

码头工人

编辑后 .env 使用您的凭据，构建并运行：

docker compose up --build -d

服务器将在以下时间可用 http://localhost:3000/mcp.

更改源代码后，重建并重新启动（Docker构建在内部编译TypeScript）：

docker compose up --build -d

要查看日志，请执行以下操作：

docker compose logs -f

发展

npm run dev    # Watch mode for TypeScript compilation

MCP检验员测试

npx @modelcontextprotocol/inspector node dist/index.js