Skip to main content

Authenticated MCP server for Teamcenter Knowledge Base APIs with Azure AD support

Project description

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-test/

✨ What's New in v0.1.2

  • 🔐 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

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-test@0.1.2"],
        "env": {
          "TEAMCENTER_API_HOST": "https://codesentinel.azurewebsites.net"
        }
      }
    }]
  }
}

🔧 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)

Add to .vscode/mcp.json:

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

JetBrains IDEs (Production)

Add to ~/.mcp.json:

{
  "mcpServers": {
    "teamcenter": {
      "command": "uvx",
      "args": ["teamcenter-mcp-server-test@0.1.2"],
      "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.1.2 (Latest) - 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-test", "--base-url", "https://teamcenter.yourcompany.com"]

Testing

Quick Test

uvx teamcenter-mcp-server-test --version

Demo/Development Setup

Start mock API server:

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

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


Development (Advanced)

Click for development setup

Installation

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

Build Package

uv build

Run Tests

uv run pytest tests/ -v

Publishing to PyPI

See DEVELOPER.md for release instructions

Files Overview

  • auth_mcp_stdio.py: Main MCP server
  • main.py: Mock API server for development
  • pyproject.toml: Package configuration

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

teamcenter_mcp_server_test-0.1.3.tar.gz (11.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

teamcenter_mcp_server_test-0.1.3-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

Details for the file teamcenter_mcp_server_test-0.1.3.tar.gz.

File metadata

File hashes

Hashes for teamcenter_mcp_server_test-0.1.3.tar.gz
Algorithm Hash digest
SHA256 fdbb395e503d5de96c79b196b3bdaa76195a868c212be611041b7763b44c4e7e
MD5 c24de61c7b2bec0e90ab81596a1b7393
BLAKE2b-256 fafba500b5a1eea99d683d9a3bb8e84c7687a116bd9f111787cd4a45e64623a5

See more details on using hashes here.

File details

Details for the file teamcenter_mcp_server_test-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for teamcenter_mcp_server_test-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b6c98c7eb765913ddc5c6b0064f7bceb0bc9badca1394bcef49400ee5622b7c2
MD5 38533bbb5fa080f4548e02da76f4ef90
BLAKE2b-256 e985eb753d570c775e25304db7490cc53a83627244f22a1c100b510a1c2aecd7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page