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.6.tar.gz (11.2 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.6-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for teamcenter_mcp_server_test-0.1.6.tar.gz
Algorithm Hash digest
SHA256 a8e1b98354e21b870deeac9b769114f2547f70da70b302ef645e3cd73f469791
MD5 e2ecb70f61b96b3d4901ae0dd873fbad
BLAKE2b-256 290f6c3167396a96bd7001afda3df351083dfa3fee38788676344ca8d8e45fbb

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for teamcenter_mcp_server_test-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 61ffa2434c0007d1d9244a1d6926e835240d5e3093b9fd59d4d03b93cc957c3c
MD5 04155a0f5306b3f2b06a042e224101c3
BLAKE2b-256 240cd0889cf73b034358baae62443be0c194c8f49a45d1b741f6954d234c1293

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