OfficeMCP v1.0.5
Самый наглядный и бесплатный способ управления приложениями Microsoft с помощью модели ИИ.
OfficeMCP
Сервер OfficeMCP предназначен для автоматизации приложений Microsoft Office (Word, Excel, PowerPoint, Access, OneNote, Visio, Project, WPS.word, Wps.powerpoint, wps.excel и т. д.) с помощью COM-интерфейса в ОС Windows. Не работает на Linux/MacOS.
Предупреждает
Пожалуйста, помните об этом, так как OfficeMCP не ограничивает использование Python. В частности, есть инструмент RunPython(...) для выполнения кодов Python, созданных моделью AI. Но это также самая замечательная часть OfficeMCP. Мы не можем гарантировать, что ваша модель AI не сделает что-то плохое с вашим компьютером. Мы не несем никакой ответственности.
Системные требования
- Система Windows
- установленный Python 3.1 или выше
- uv установлен откройте окно оболочки и выполните команду
pip установить uv
Как установить OfficeMCP
Существует два способа или два режима установки OfficeMCP (их также можно использовать одновременно):
1. Используйте OfficeMCP в качестве stdio-сервера:
- Один сервер OfficeMCP для одного режима клиента mcp
- Добавьте следующую настройку в файл MCP.json для vscode или в другое подходящее место для другой AI IDE:
{
"mcpServers": {
"OfficeMCP": {
"type": "stdio",
"command": "uvx",
"args": [
"officemcp"
]
}
}
}
2. Используйте OfficeMCP в качестве сервера SSE:
- Один сервер OfficeMCP для режима нескольких клиентов mcp
- Вы можете изменить порт и хост по своему усмотрению.
- Это рекомендуемый способ использования сервера OfficeMCP.
шаг 1:
Выполните одну команду в shell или power shell:
uvx officemcp sse
URL-адрес сервера McP будет: " http://127.0.0.1:8888/sse " или " http://127.0.0.1:8888/sse ", рабочая папка по умолчанию - D:@officemcp
или что-то вроде ниже
uvx officemcp sse --port 7777 --host 127.0.0.8 --folder D:\myfolder
"url" будет: " http://127.0.0.8:7777/sse "
шаг 2:
Добавьте следующую настройку в файл MCP.json для vscode или в другое подходящее место для другой AI IDE:
{
"servers": {
"OfficeMCP": {
"url": "http://127.0.0.1:8888/sse"
}
}
}
или
{
"servers": {
"OfficeMCP": {
"url": "http://{your_host}:{your_port}/sse"
}
}
}
Использование
В AI IDE вы можете поручить модели AI управлять приложениями Office с помощью сервера OfficeMCP:
- Вы просите модель ИИ открыть новое приложение Office. Модель ИИ отправит запрос на сервер OfficeMCP, и сервер OfficeMCP откроет новое приложение Office.
- Вы просите модель ИИ сделать все, что вы хотите сделать в текущем приложении Office. Модель ИИ проанализирует ваш запрос и вызовет инструмент сервера OfficeMCP для выполнения вашего запроса.
Справочник инструментов
Инструменты:
- AvailableApps(): проверьте, установлены ли на вашем компьютере приложения Microsoft Office.
- RunningApps(): получение списка запущенных в данный момент приложений Office.
- IsAppAvailable(...): проверяет, установлено ли определенное приложение Office.
- Запустить(...): запустить новое приложение Office и настроить его видимость.
- Видимый(...): устанавливает видимость указанного приложения Office на значение True или False.
- Quit(...): выход из указанного приложения Office.
- Demonstrate(): запустить демонстрацию функций автоматизации OfficeMCP.
- Speak(...): произнести переданную вами строку.
- Звуковой сигнал(...): воспроизвести звуковой сигнал.
- DefaultFolder(...): возвращает корневую рабочую папку OfficeMCP, по умолчанию это ("D:\OfficeMCP")
- IsFileExists(sub_path): проверяет, существует ли файл в корневой папке OfficeMCP.
- DownloadImage(...): загрузить изображение с указанного URL-адреса и сохранить его по указанному пути.
- RunPython(codes,data): запустить код Python в контексте сервера OfficeMCP.
- Это самый мощный инструмент на сервере OfficeMCP. ИИ может использовать этот инструмент для выполнения любых задач, поддерживаемых сервером, включая автоматизацию приложений Office.
- Существует объект «Officer», который можно использовать в коде Python, например,
Officer.Excel содержит текущее приложение Excel com, а также Officer.Word, Officer.Powerpoint, Office.Visio, Officer.Access, Officer.OneNote, Officer.Visio, Officer.Project. Office.Kwps для WPS Word, Office.Ket для WPS Excell, Office.Kwpp для WPS PowerPoint. - Существует объект «output», возвращаемый RunPython(...), который можно использовать в коде Python, чтобы поместить собственный возвращаемый результат в output, например, output="run python sccessed", а затем RunPython вернет «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.
- В будущем будут добавлены дополнительные инструменты.
Разработка
git clone https://github.com/officemcp/officemcp