A production-grade Model Context Protocol server that connects Claude (or any MCP client) to SAP SuccessFactors via OData APIs. Query employee data, manage permissions, run compliance reports, and administer HR operations — all through natural language.
You: "Who on the Engineering team has a work anniversary this month?"
Claude: [calls get_anniversary_employees] Found 3 upcoming anniversaries...
- Jane Smith (5 years - milestone!) - March 12
- Bob Johnson (2 years) - March 18
- Alice Chen (10 years - milestone!) - March 25
SAP SuccessFactors MCP server — 43 HR tools for Claude Desktop & Cloud Run. Query employees, permissions, time off, hiring, compliance, and more via natural language.
Bintang
13
Tool
—
Uptime
—
Why SF-MCP?
Challenge
SF-MCP Solution
SAP SuccessFactors APIs are complex and verbose
62 purpose-built tools with clean interfaces
Building OData queries requires deep SF knowledge
Natural language — ask Claude in plain English
Security concerns with API access
Per-request auth, input validation, audit logging
Managing multiple SF instances
21 data centers supported, cross-instance comparison
Zero boilerplate — The sf_tool decorator handles request ID generation, timing, audit logging, input validation, credential checking, error handling, and $top clamping. Tool functions contain only business logic.
Secure by default — 10 input validators (regex allowlists), OData injection prevention, XXE-safe XML parsing (defusedxml), timing-safe API key comparison (hmac.compare_digest), and automatic credential masking in logs.
Production-ready — Connection pooling (requests.Session), mutation-safe response caching (deep-copy on put/get), sliding-window rate limiting with automatic 429 retry, and Cloud Logging-compatible JSON audit trail.
Schema-clean — Internal parameters (request_id, start_time, api_host) are hidden from the MCP tool schema via FastMCP's Dependency injection, keeping tool interfaces clean for LLM consumers.
Entity paths, $select, $orderby, $filter, $expand all validated; control characters rejected
Authentication
Per-request credentials (never stored); timing-safe API key comparison via hmac.compare_digest
XML safety
defusedxml prevents XXE, entity expansion, and DTD attacks
Audit logging
Every tool call logged with structured JSON; passwords automatically masked
Cache safety
Deep-copied on store and retrieval to prevent mutation bugs
Date handling
All SAP timestamp parsing uses explicit UTC to prevent timezone inconsistencies
Testing
# Run all 110 tests
uv run pytest tests/ -v
# Run with coverage
uv run pytest tests/ --cov=sf_mcp
# Lint
uv run ruff check .
# Type check
uv run mypy sf_mcp/
Test coverage includes:
Config — DC mapping resolution, case insensitivity, aliases, error cases
Validation — All 10 validators with valid/invalid inputs, injection prevention
This project is licensed under the MIT License — see the LICENSE file for details.
S
Sf
aiadiguru2025·13 bintang·
SAP SuccessFactors MCP server — 43 HR tools for Claude Desktop & Cloud Run. Query employees, permissions, time off, hiring, compliance, and more via natural language.
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Pertanyaan
Bagaimana cara menginstal Sf?
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Apakah Sf memerlukan kunci API?
Tidak ada variabel lingkungan wajib yang tercantum di catatan ini.
Transport apa yang digunakan Sf?
Sf berjalan secara lokal melalui stdio.
Kapan Sf terakhir diperiksa?
Terakhir diperiksa 2026-11-05. SAP SuccessFactors MCP server — 43 HR tools for Claude Desktop & Cloud Run. Query employees, permissions, time off, hiring, compliance, and more via natural language.