papamzor/personal-mcp-servicenow

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

26 stars 9 forks Качество 81 Тренд 19MIT

Начинался как личный проект, но превратился в нечто, широко используемое на рабочем месте и за его пределами. Сервер MCP для ServiceNow

Обзор

MCP-сервер для интеграции ServiceNow. Использует FastMCP для стрио-транспорта, учетные данные клиентов OAuth 2.0. Текущий выпуск: (25 инструментов). Поверхность 5.0.0 «Борон» ломалась — отобрали 39 → 25 с одним минимальным ответным контрактом. При обновлении с v4 прочитайте MIGRATION v4 to v5.md. Полная история в CHANGELOG.md. † Поставленная версия строки шла 4.0.0 → 4.3.0 напрямую. Ни 4.1.0, ни 4.2.0 никогда не были выпущены или помечены — «4.1.0» обозначает объем работы в CHANGELOG, а не устанавливаемую версию. v4.0 был прорывным. См. MIGRATION v3 to v4.md при обновлении с v3. Обратно-совместимые шимы сохранили все пути импорта v3 и цели проверки, работающие для одного цикла выпуска; они были удалены в 4.1.0. Импорт из http layer, oauth и фильтра напрямую. Это работает на Windows 11 и macOS и занимает около 2 минут. Спросите свой ИТ-отдел о 3 вещах: - Адрес ServiceNow вашей компании (выглядит как https://company.service-now.com) - Идентификатор клиента - Секрет клиента) 1.

Обзор (машинный перевод)

MCP-сервер для интеграции ServiceNow. Использует FastMCP для стрио-транспорта, учетные данные клиентов OAuth 2.0.

##Поддержите проект

Освещение

Текущий выпуск: 5.0.2 (25 инструментов). Поверхность 5.0.0 «Борон» ломалась — отобрали 39 → 25 с одним минимальным ответным контрактом. При обновлении с v4 прочитайте MIGRATION v4 to v5.md. Полная история в CHANGELOG.md.

Оригинальное название: What Changed [скрыто] [скрыто] | 5.0.2 | readOnlyHint подается на всех 25 инструментах (19 читать / 6 писать), поэтому хосты могут автоматически одобрять чтения. Зависимости заблокированы: uv.lock, отправленные в .mcpb uv run --frozen --no-dev, fastmcp **Do not pass secrets with -e KEY = значение .** They land in shell history and are visible via ps /, докер проверяет . Use –env-файл для локального тестирования; см. Производство: Azure Container Apps + Key Vault для производства.

Изображение устанавливается MCP_TRANSPORT=sse по умолчанию. Агенты подключаются http:// :8000/sse.

Конфигурация

[10] в корне проекта:

Требуются учетные данные клиентов OAuth 2.0. Базовый аут не поддерживается. См. OAUTH SETUP GUIDE.md для настройки на стороне ServiceNow.

Claude Desktop/Claude Code

Claude Desktop — местоположение файла конфигурации:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Personal MCP ServiceNow Integration

MCP server for ServiceNow integration. Uses FastMCP over stdio transport, OAuth 2.0 client credentials.

Support This Project

Release highlights

Current release: 5.0.2 (25 tools). The 5.0.0 “Boron” surface was breaking — culled 39 → 25 with one minimal response contract. If upgrading from v4, read MIGRATION_v4_to_v5.md. Full history in CHANGELOG.md.

Release	What changed
5.0.2	`readOnlyHint` served on all 25 tools (19 read / 6 write) so hosts can auto-approve reads. Dependencies locked: `uv.lock` shipped in the `.mcpb` (`uv run --frozen --no-dev`), `fastmcp<4` ceiling (4.0.x deferred), direct pins pruned 20 → 6, `pip-audit` clean. No tool-surface change.
5.0.1	Two silent-data-loss fixes in `get_kb_articles_by_state`, both found live. A `draft` filter now finds drafts on already-published articles (the priority collapse hid them — live, 1 reported against 48 real); entries carry `states_present` and the state filter tests membership. The raw scan no longer inherits `max_results`, which had made a truncated fetch report the wrong `current_state`; a capped scan now says `scan_incomplete` instead of guessing.
5.0.0 “Boron”	Breaking. Tool surface culled 39 → 25 (5 diagnostics folded into one `health_check`; the NL/filter and smart-KB/SLA read tools removed — the host model does NL→filter natively). One minimal response contract across every tool: list `{result, returned_count, truncated}`, single-record `{record}`, write `{record, message}`, failure `{error:{code, message}}` — no more bare-string returns or `result`-is-sometimes-a-dict. `TableSpec` makes per-table config one source of truth; tool selection guidance is a structured registry injected into each docstring. ~2000 lines of dead NL-engine code removed. See MIGRATION_v4_to_v5.md.
4.5.0	Tool-selection docstring protocol on all 39 tools (WHEN TO USE / WHEN NOT TO USE / PREFER OVER / TABLES / SIDE EFFECT / EXAMPLE). Non-breaking — no tool added, removed, or re-signatured. The fatal footguns (LIKE-not-CONTAINS, reference fields hold sys_ids) now sit inline on `search_records` and `filter_records`. Static tool-selection preferred-hit rose 21/30 → 29/30, ambiguity 66 → 50 plausible paths.

Открыть полный README на GitHub

Установка

docker run -d \

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "servicenow": {
      "command": "python",
      "args": ["/full/path/to/personal-mcp-servicenow/personal_mcp_servicenow_main.py"]
    }
  }
}