오피스MCP v1.0.5

Name: OfficeMCP
Author: OfficeMCP

AI 모델을 통해 Microsoft 애플리케이션을 제어하는 가장 눈에 띄고 무료인 방법입니다.

PyPI - 버전

오피스MCP

OfficeMCP 서버는 Windows OS의 COM 인터페이스를 통해 AI가 Microsoft Office 애플리케이션(Word, Excel, PowerPoint, Access, OneNote, Visio, Project, WPS.word, Wps.powerpoint, wps.excel 등)을 자동화하도록 설계되었습니다. Linux/MacOS에서는 작동하지 않습니다.

경고하다

OfficeMCP는 Python 사용을 제한하지 않으므로 유의하시기 바랍니다. 특히 AI 모델로 생성된 Python 코드를 실행하는 RunPython(...) 도구가 있습니다. 하지만 이는 OfficeMCP의 가장 훌륭한 기능 중 하나이기도 합니다. AI 모델이 컴퓨터에 악영향을 미치지 않을 것이라고 보장할 수는 없으며, 어떠한 책임도 지지 않습니다.

시스템 요구 사항

윈도우 시스템
python 3.1 이상 설치됨
uv가 설치되어 쉘 창을 열고 명령을 실행합니다.
pip로 uv 설치

OfficeMCP 설치 방법

OfficeMCP를 설치하는 데는 두 가지 방법 또는 두 가지 모드가 있습니다(두 가지를 동시에 사용할 수도 있습니다):

1. OfficeMCP를 stdio 서버로 사용:

하나의 MCP 클라이언트 모드에 대한 하나의 OfficeMCP 서버
vscode의 MCP.json 파일이나 다른 AI IDE의 적절한 위치에 다음 설정을 넣으세요.

지엑스피1

2. OfficeMCP를 sse 서버로 사용:

다중 MCP 클라이언트 모드를 위한 하나의 OfficeMCP 서버
원하는 대로 포트와 호스트를 변경할 수 있습니다.
OfficeMCP 서버를 사용하려면 이 방법이 권장됩니다.

1단계:

셸이나 파워셸에서 하나의 명령을 실행합니다.

uvx officemcp sse

Mcp 서버 URL은 " http://127.0.0.1:8888/sse " 또는 " http://127.0.0.1:8888/sse "입니다. 기본 작업 폴더는 D:@officemcp입니다.

또는 아래와 같은 것

uvx officemcp sse --포트 7777 --호스트 127.0.0.8 --폴더 D:\myfolder

"url"은 " http://127.0.0.8:7777/sse "가 됩니다.

2단계:

vscode의 MCP.json 파일이나 다른 AI IDE의 적절한 위치에 다음 설정을 넣으세요.

{ "servers": { "OfficeMCP": { "url": "http://127.0.0.1:8888/sse" } } }

또는

{ "servers": { "OfficeMCP": { "url": "http://{your_host}:{your_port}/sse" } } }

Related MCP server: Office Word MCP Server

용법

AI IDE에서는 AI 모델이 OfficeMCP 서버를 통해 Office 애플리케이션을 제어하도록 요청할 수 있습니다.

AI 모델에게 새 Office 애플리케이션을 열도록 요청합니다. AI 모델은 OfficeMCP 서버로 요청을 보내고, OfficeMCP 서버는 새 Office 애플리케이션을 엽니다.
AI 모델에 현재 Office 애플리케이션에서 원하는 작업을 요청하세요. AI 모델은 요청을 분석하고 OfficeMCP 서버 도구를 호출하여 요청을 처리합니다.

도구 참조

도구:

AvailableApps(): Microsoft Office 애플리케이션이 컴퓨터에 설치되어 있는지 확인합니다.
RunningApps(): 현재 실행 중인 Office 응용 프로그램 목록을 가져옵니다.
IsAppAvailable(...): 특정 Office 응용 프로그램이 설치되어 있는지 확인합니다.
Launch(...): 새 Office 응용 프로그램을 시작하고 표시 여부를 설정합니다.
Visible(...): 지정된 Office 응용 프로그램의 표시 여부를 True 또는 False로 설정합니다.
Quit(...): 지정된 Office 응용 프로그램을 종료합니다.
Demonstrate(): OfficeMCP 자동화 기능 데모를 실행합니다.
Speak(...): 전달한 문자열을 말합니다.
비프음(...): 비프음을 냅니다.
DefaultFolder(...): OfficeMCP 루트 작업 폴더 기본값을 반환합니다("D:\OfficeMCP")
IsFileExists(sub_path): OfficeMCP 루트 폴더에 파일이 있는지 확인합니다.
DownloadImage(...): 주어진 URL에서 이미지를 다운로드하여 지정된 경로에 저장합니다.
RunPython(코드, 데이터): OfficeMCP 서버 컨텍스트에서 Python 코드를 실행합니다.
- OfficeMCP 서버에서 가장 강력한 도구입니다. AI는 이 도구를 사용하여 Office 애플리케이션 자동화를 포함하여 서버가 지원하는 모든 작업을 수행할 수 있습니다.
- 파이썬 코드에서 사용할 수 있는 "Officer" 객체가 있습니다. 예를 들어, Officer.Excel 현재 Excel com 애플리케이션을 저장하고, 그 외에도 Officer.Word, Officer.Powerpoint, Office.Visio, Officer.Access, Officer.OneNote, Officer.Visio, Officer.Project가 있습니다. WPS Word의 경우 Office.Kwps, WPS Excel의 경우 Office.Ket, WPS PowerPoint의 경우 Office.Kwpp가 있습니다.
- RunPython(...)이 반환하는 객체인 "output"을 python 코드에서 사용할 수 있는데, output="run python sccessed"와 같이 반환 결과를 직접 output에 넣으면 RunPython이 AI 모델에 "run python sccessed"를 반환합니다.
- Officer.Visio를 사용하여 새 Visio 문서를 만든 다음 Officer.Visio.ActivePage를 사용하여 활성 페이지를 가져오고 Officer.Visio.ActivePage.DrawRectangle(...)을 사용하여 페이지에 사각형을 그릴 수 있습니다.
- Officer.Excel을 사용하여 새 Excel 문서를 만든 다음 Officer.Excel.ActiveSheet를 사용하여 활성 시트를 가져오고, Officer.Excel.ActiveSheet.Cells(...)를 사용하여 셀을 가져오고, Officer.Excel.ActiveSheet.Cells(...).Value = "hello"를 사용하여 셀 값을 설정할 수 있습니다.
- RunPython 도구로 코드를 실행하여 코드를 제어합니다.
앞으로 더 많은 도구가 추가될 예정입니다.