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

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for teamcenter_mcp_server_test-0.1.5.tar.gz
Algorithm Hash digest
SHA256 8f50e31f6424ec4e34209bb23b4acec16260ba8f3fad33d0b463edbf115e49fd
MD5 b75857d6b892a84859e0af1fd800d2ef
BLAKE2b-256 1e5651bd820e42a755bb2a0dfeeba4b5985810b3237732cf8c87b6160226ff2f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for teamcenter_mcp_server_test-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 f6f00bcbe4fa9fb1038f1d8ea5c72acbe0842a4ab2c1c70cdf18be0bdc74d984
MD5 287ab39d550c60885fbb7410b20aa6a7
BLAKE2b-256 5dd49f0371d6aaeffa9f8bb897197a77c14b441b0fb2bb2b39bdcd85cef89b28

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