个人MCP服务工具

Dependencies

Production: requirements.txt Dev (pytest, coverage, tiktoken, pytest-asyncio): requirements-dev.txt Dev dependencies are never installed in the Docker image.

---

Installation

Docker (cloud / network agents)

For hosting over the network (N8N, LangChain, any MCP-compatible agent):

docker build -t mcp-servicenow .

docker run -d \
  -p 8000:8000 \
  --env-file .env.local \
  --name mcp-servicenow \
  mcp-servicenow

Do not pass secrets with -e KEY=value. They land in shell history and are visible via ps / docker inspect. Use --env-file for local testing; see Production: Azure Container Apps + Key Vault for production.

The image sets MCP_TRANSPORT=sse by default. Agents connect at http://<your-host>:8000/sse.

---

Configuration

Create .env in project root:

SERVICENOW_INSTANCE=https://your-instance.service-now.com
SERVICENOW_CLIENT_ID=your_oauth_client_id
SERVICENOW_CLIENT_SECRET=your_oauth_client_secret

OAuth 2.0 client credentials are required. Basic auth is not supported. See OAUTH_SETUP_GUIDE.md for ServiceNow-side setup.

---

Personal MCP ServiceNow Integration

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

---

Claude Desktop / Claude Code integration

Claude Desktop — config file location:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

Credentials are read from the .env file. If you prefer to inject them via the config:

{
  "mcpServers": {
    "servicenow": {
      "command": "python",
      "args": ["/full/path/to/personal-mcp-servicenow/personal_mcp_servicenow_main.py"],
      "env": {
        "SERVICENOW_INSTANCE": "https://your-instance.service-now.com",
        "SERVICENOW_CLIENT_ID": "your_oauth_client_id",
        "SERVICENOW_CLIENT_SECRET": "your_oauth_client_secret"
      }
    }
  }
}

Claude Code (remote SSE):

{
  "mcpServers": {
    "servicenow": {
      "type": "sse",
      "url": "http://<your-host>:8000/sse"
    }
  }
}

---