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.4.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.4-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for teamcenter_mcp_server_test-0.1.4.tar.gz
Algorithm Hash digest
SHA256 6801082a544922cb4fe2d5432cc1d1a72ed39c2aca72aa91151fed340ddd2f84
MD5 9679ce2ada4d835d2b0a5461ccbdc5e9
BLAKE2b-256 063c03180855b90880ef216d96cea7acffa9784397f93f5855ad9792af853067

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for teamcenter_mcp_server_test-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 675bdd85101eecee505c729a93312d19704ffd95640aba7367cff64bbd6d89bc
MD5 329bbab413d1a0319d43544667c90d11
BLAKE2b-256 2c6c54d3e4a99ff9d0a33f44f83c446045f52148e65eb54bfe6c8dd02f0c8655

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