convez.ai
MCP ServerSegurançaIntermediário
TrustSource

TrustSource MCP Server

TrustSource/ts-mcp

Gerenciamento de SBOMs e compliance via API TrustSource para agentes LLM

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe a API v2 do TrustSource para gerenciamento de SBOMs, compliance checks, rastreamento de vulnerabilidades e gestão de risco via linguagem natural. Integra-se nativamente com Claude e outros clientes MCP-compatíveis através de stdio ou HTTP.

Instalação

$npx convez-ai TrustSource/ts-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 6 dias
Versão
—
Issues abertas
5
Contribuidores
1

Casos de uso

  • Automatizar verificações de conformidade e compatibilidade de licenças
  • Gerenciar SBOMs (Software Bill of Materials) em fluxos CI/CD
  • Rastrear vulnerabilidades e riscos de segurança em dependências
  • Submeter scans de dependências e importar resultados SARIF/CycloneDX

Veredito

Excelente integração para equipes que precisam automatizar compliance e gestão de vulnerabilidades em pipelines DevSecOps. A abordagem MCP permite que Claude acesse SBOMs e relatórios de risco de forma conversacional, simplificando auditorias e rastreamento de dependências.

README

A tradução para o português deste README ainda está na fila.

TrustSource MCP Server

An MCP (Model Context Protocol) server that exposes the TrustSource REST API v2 as domain-grouped tools for LLM agents. It lets Claude and other MCP-capable assistants manage SBOMs, run compliance checks, track vulnerabilities, and handle risk management — all through natural language.

Quick Start

docker run -i --rm \
  -e TS_API_KEY=your-api-key \
  trustsource/ts-mcp

That's it. The server speaks MCP over stdio and is ready to be used by any MCP client.

Configuration

VariableRequiredDefaultDescription
TS_API_KEYYes—TrustSource API key (how to obtain one)
TS_ACCESS_MODENoreadAccess tier: read, readwrite, or full
TS_TRANSPORTNostdioTransport mode: stdio or http
TS_HTTP_PORTNo3000HTTP listen port (only used with http transport)
TS_API_BASE_URLNohttps://api.trustsource.io/v2TrustSource API base URL
TS_LOG_LEVELNoinfoLog level: debug, info, warn, error

Transport Modes

stdio (default)

For local use with Claude Desktop, Claude Code, or other MCP clients that launch the server as a subprocess.

Streamable HTTP

For server deployment where multiple clients connect over the network. Each client gets an isolated session via Mcp-Session-Id headers.

docker run -p 3000:3000 \
  -e TS_API_KEY=your-api-key \
  -e TS_TRANSPORT=http \
  trustsource/ts-mcp

The server exposes:

  • POST /mcp — MCP Streamable HTTP endpoint
  • GET /health — Health check ({"status":"ok","version":"..."})

MCP Client Setup

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "trustsource": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "TS_API_KEY", "trustsource/ts-mcp"],
      "env": {
        "TS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Add to your project or user .claude/settings.json:

{
  "mcpServers": {
    "trustsource": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "TS_API_KEY",
        "-e", "TS_ACCESS_MODE=readwrite",
        "trustsource/ts-mcp"
      ],
      "env": {
        "TS_API_KEY": "your-api-key"
      }
    }
  }
}

To enable write operations, set TS_ACCESS_MODE to readwrite or full as shown above.

Available Tools

The server exposes 16 domain-grouped tools. Each tool bundles related API operations as actions.

ToolDescription
accountCheck API key authorization status
projectsList, create, update, delete projects; retrieve parts lists and SBOMs
modulesList, create, update, delete modules; retrieve parts lists and SBOMs
productsManage products, misuse reports, support contacts, solutions, photos, documents
scansSubmit dependency scans, view results, import SBOMs (CycloneDX, SPDX)
testsImport SARIF test results for security analysis
reportsRetrieve compliance, vulnerability, license, CVE, dashboard, and EOL reports
releasesAccess published SBOMs, notice files, and CSAF/VEX advisories
compliance-checkCheck license compatibility and component compliance against FOSS policies
approvalsList, view, approve, and reject compliance approval requests
companyRetrieve company FOSS compliance settings and policies
vulnerabilitiesLook up CVE/CWE details, search by keyword or component
psirtAccess Product Security Incident Response CSAF/VEX advisories
deepscanTrigger and retrieve repository deep scans for license and security analysis
risksList, create, update, delete risk assessments and tasks
usersView user activity and API usage statistics

Example Prompts

Once the MCP server is connected, you can ask Claude things like:

  • "List all my TrustSource projects" — calls projects with the list action
  • "Show the SBOM for project abc-123" — retrieves the full software bill of materials
  • "Check if the MIT license is compliant with our company policy" — runs a compliance check
  • "Find CVEs related to log4j" — searches the vulnerability database
  • "Get the compliance report for module xyz" — pulls a formatted compliance report
  • "Show all pending approval requests and summarize them" — lists open approval workflows
  • "Trigger a deep scan on repository github.com/org/repo" — starts a license and security deep scan
  • "What risks are tracked for project abc-123?" — retrieves risk assessments and tasks

Access Modes

The TS_ACCESS_MODE environment variable controls which operations the server exposes. This lets you enforce least-privilege access.

read (default)

Only GET operations. The agent can list and view resources but cannot modify anything.

Examples: list projects, view SBOMs, read reports, search vulnerabilities, check compliance

readwrite

GET plus create and update operations. The agent can add new resources and modify existing ones.

Examples: everything in read, plus: create projects, submit scans, import SBOMs, create risk assessments, update products

full

All operations including destructive and approval actions. Use with caution.

Examples: everything in readwrite, plus: delete projects/modules, retire products, approve/reject compliance requests

Actions that require a higher access mode than configured are not registered as tools — the agent cannot see or call them.

Development

Prerequisites

  • Node.js >= 20
  • npm

Build and Run

# Install dependencies
npm install

# Generate tool definitions from the OpenAPI spec and domain mapping
npm run codegen

# Build TypeScript
npm run build

# Run in development mode (tsx, no build step)
npm run dev

# Run the built server
npm start

Docker

# Build the Docker image locally
npm run docker:build

# Run it
docker run -i --rm -e TS_API_KEY=your-key trustsource/ts-mcp

API Key

To obtain a TrustSource API key:

  1. Log in to TrustSource
  2. Navigate to Company Admin > Scanners & API
  3. Create a new API key or copy an existing one

The API key is validated on server startup. If it is missing or invalid, the server exits with a clear error message.

License

Apache-2.0

Ver o original no GitHub

Bom para

Relacionados