Teamcenter MCP Server

Universal MCP server for integrating AI assistants with Teamcenter Knowledge Base APIs with Azure AD authentication support.

📦 Live on PyPI: https://pypi.org/project/teamcenter-mcp-server/

✨ What's New in v0.2.0

• 🔐 Azure AD Authentication - Connect to real Teamcenter APIs
• 🔄 Hybrid Mode - Seamless switching between localhost mock and production
• 🌍 Environment Variables - Configure via TEAMCENTER_API_HOST
• 🛡️ Secure - Uses cached Azure AD cookies, no secrets in code

📋 Project Status & Technical Analysis →

Quick Start (Just Copy & Paste)

🚀 Production Mode (Azure AD)

Add to ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [{
      "transport": {
        "type": "stdio",
        "command": "uvx",
        "args": ["teamcenter-mcp-server@0.2.0"],
        "env": {
          "TEAMCENTER_API_HOST": "https://codesentinel.azurewebsites.net",
          "CODESESS_COOKIE": "<your-codesess-cookie>",
          "AZURE_CLIENT_ID": "<your-azure-client-id>",
          "AZURE_TENANT_ID": "<your-azure-tenant-id>"
        }
      }
    }]
  }
}

🔧 Development Mode (Localhost Mock)

Add to ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [{
      "transport": {
        "type": "stdio",
        "command": "uvx",
        "args": ["teamcenter-mcp-server-test@0.1.2"]
      }
    }]
  }
}

VS Code (Production)

Note: VSCode MCP integration is currently not working within Siemens intranet environments. This configuration is on hold pending resolution of corporate network restrictions.

Add to .vscode/mcp.json:

{
  "servers": {
    "teamcenter": {
      "type": "stdio",
      "command": "uvx",
      "args": ["teamcenter-mcp-server@0.2.0"],
      "env": {
        "TEAMCENTER_API_HOST": "https://codesentinel.azurewebsites.net"
      }
    }
  }
}

JetBrains IDEs (Production)

Add to ~/.mcp.json:

{
  "mcpServers": {
    "teamcenter": {
      "command": "uvx",
      "args": ["teamcenter-mcp-server@0.2.0"],
      "env": {
        "TEAMCENTER_API_HOST": "https://codesentinel.azurewebsites.net"
      }
    }
  }
}

🔐 Azure AD Authentication Setup

Prerequisites

1. Authenticate first using the working Python client:

   # Run this once to cache Azure AD credentials
   python /path/to/easy_auth_client.py ask "test"
   

2. Verify authentication works:

   # Check for cached cookie
   ls ~/.teamcenter_easy_auth_cache.json
   

Environment Variables

• TEAMCENTER_API_HOST: API endpoint URL
  • Production: https://codesentinel.azurewebsites.net
  • Development: http://localhost:8000 (default)

📦 Version History

• v0.2.0 (Latest) - Azure AD authentication + hybrid mode
• v0.1.2 - Azure AD authentication + hybrid mode
• v0.1.1 - Localhost mock only (legacy)

Usage

→ See USAGE.md for copy & paste examples ←

Quick examples:

• VS Code: @workspace get Teamcenter API documentation for part creation
• Continue.dev: @MCP search for PLM workflow integration documentation

Production Setup

Replace http://localhost:8000 with your real Teamcenter API:

"args": ["teamcenter-mcp-server", "--base-url", "https://teamcenter.yourcompany.com"]

Testing

Quick Test

uvx teamcenter-mcp-server --version

Demo/Development Setup

Start mock API server:

git clone https://github.com/your-repo/teamcenter-mcp
cd teamcenter-mcp
uv run uvicorn main:app --reload

Server runs on http://localhost:8000 - use this URL in configs above.

Development (Advanced)

curl -LsSf https://astral.sh/uv/install.sh | sh

uv build

uv run pytest tests/ -v