Integration with PyPI for package distribution, allowing users to install the OfficeMCP server using pip or uv package managers.
Allows execution of Python code in the server context via the RunPython tool, enabling custom automation tasks and direct interaction with Office application COM objects.
Used to display the current PyPI package version badge in the README documentation.
오피스MCP v1.0.5
AI 모델을 통해 Microsoft 애플리케이션을 제어하는 가장 눈에 띄고 무료인 방법입니다.
오피스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의 적절한 위치에 다음 설정을 넣으세요.
또는
용법
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 도구로 코드를 실행하여 코드를 제어합니다.
- 앞으로 더 많은 도구가 추가될 예정입니다.
개발
This server cannot be installed
Windows에서 COM 인터페이스를 통해 AI 모델이 Microsoft Office 애플리케이션(Word, Excel, PowerPoint 등)을 자동화할 수 있는 서버로, Office 기능에 대한 자연어 제어가 가능합니다.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with ClickUp workspaces, allowing task creation, management, and workspace organization through natural language commands.Last updated -255MIT License
- -securityFlicense-qualityA server that enables AI systems to browse, retrieve content from, and interact with web pages through the Model Context Protocol.Last updated -
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to create, read, edit, and format Microsoft Word documents through standardized tools and resources.Last updated -16139PythonMIT License
- AsecurityAlicenseAqualityA server that enables AI assistants to interact with the Omnisend marketing platform, supporting contact management, product management, and event tracking operations through natural language.Last updated -10TypeScriptApache 2.0