papamzor/personal-mcp-servicenow
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
個人的なプロジェクトとして始まり、自分の職場やそれを超えて広く使われているものへと発展しました。 サービスなしのMCPサーバー
概要
ServiceNow 統合用の MCP サーバー。 stdio トランスポート、OAuth 2.0 クライアントの資格情報で FastMCP を使用します。 現在のリリース: (25 ツール). 5.0.0 "Boron" 表面が壊れていました。39 → 25を1つの最小限の応答契約で計算しました。 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 はリリースを中断しました。 v3 からアップグレードする場合は MIGRATION v3 to v4.md を参照してください。 Backwards-compat のシムは 1 つのリリース サイクルのために働くすべての v3 のインポート パスおよびテスト パッチ ターゲットを維持しました; それらは 4.1.0 で削除されました。 http layer、oauth、フィルタから直接インポートします。 Windows 11とmacOSで動作します。 あなたのIT部門に3つのことを尋ねてください。 - あなたの会社のServiceNowアドレス([https://company.service-now.com)のように見える) - クライアントID - クライアントシークレット 1.
概要（AI 翻訳）
ServiceNow 統合用の MCP サーバー。 stdio トランスポート、OAuth 2.0 クライアントの資格情報で FastMCP を使用します。
お問い合わせ
このプロジェクトをサポート
お問い合わせ
リリースハイライト
現在のリリース:5.0.2 (25ツール)。 5.0.0 “Boron” 表面が壊れていました。39 → 25を1つの最小限の応答契約で計算しました。 v4 からアップグレードする場合は、MIGRATION v4 to v5.md をお読みください。 CHANGELOG.mdの歴史
| リリース | 変更について |
お問い合わせ
|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[[T6]ドッカー検査`. Use `]-----env-file` ローカルテスト用; 製造を参照してください: Azure Container Apps + 生産のためのキーボルト。
デフォルトで MCP_TRANSPORT=sse が設定されます。 [[T9] でエージェントが接続します。
お問い合わせ
設定
プロジェクトルートで[.envを作成します。
OAuth 2.0 クライアントの資格情報が必要です。 基本的なauthはサポートされていません。 OAUTH SETUP GUIDE.md を ServiceNow-side の設定で参照してください。
お問い合わせ
#Claudeデスクトップ/Claudeコード統合
Claude Desktop — ファイルの場所の設定:
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
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. |
インストール
docker run -d \設定
{
"mcpServers": {
"servicenow": {
"command": "python",
"args": ["/full/path/to/personal-mcp-servicenow/personal_mcp_servicenow_main.py"]
}
}
}