VISO TRUST MCP Server

chính thức

Truy cập và quản lý chương trình rủi ro bên thứ ba VISO TRUST của bạn trực tiếp thông qua trợ lý AI.

GitHub

Tài liệu

VISO TRUST MCP Server

Máy chủ Model Context Protocol (MCP) để tích hợp các khả năng của API VISO TRUST với trợ lý AI.

Yêu cầu

Java 21+
Gradle
Docker (tùy chọn cho triển khai container hóa)
MCP Inspector (tùy chọn để kiểm thử)

Cấu hình

Cấu hình API VISO TRUST

Các thuộc tính sau có thể được cấu hình cho API VISO TRUST:

visotrust.api.base-url: URL cơ sở cho API VISO TRUST (mặc định: http://localhost:8080)
visotrust.api.token: Token API của bạn từ nền tảng VISO TRUST (bắt buộc)
visotrust.api.timeout: Thời gian chờ yêu cầu API tính bằng mili giây (mặc định: 30000)
visotrust.api.connect-timeout: Thời gian chờ kết nối API tính bằng mili giây (mặc định: 5000)

Để biết thông tin về cách tạo token API cho biến môi trường visotrust.api.token, hãy xem tài liệu hỗ trợ VISO TRUST.

Hồ sơ ứng dụng

Ứng dụng này hỗ trợ các hồ sơ Spring Boot để kích hoạt các cấu hình khác nhau cho các kịch bản triển khai khác nhau.

Hồ sơ từ xa

Hồ sơ remote được thiết kế đặc biệt cho hỗ trợ MCP từ xa sử dụng Server-Sent Events (SSE). Hồ sơ này cấu hình ứng dụng để hoạt động tối ưu trong môi trường phân tán nơi máy chủ MCP cần giao tiếp với các máy khách từ xa qua kết nối HTTP/SSE.

Các điểm khác biệt chính trong hồ sơ từ xa:

Được cấu hình cho giao tiếp dựa trên SSE thay vì I/O tiêu chuẩn
Cài đặt máy chủ được tối ưu hóa cho kết nối máy khách từ xa
Ghi nhật ký nâng cao để gỡ lỗi phân tán

Cách kích hoạt hồ sơ từ xa:

Khi chạy trực tiếp với Java:

java -jar viso-mcp-server-<version>.jar --spring.profiles.active=remote

Khi chạy với Gradle:

./gradlew bootRun --args="--spring.profiles.active=remote"

Khi sử dụng Docker:

docker run -i --rm \
  -e VISOTRUST_API_TOKEN=<your-api-token> \
  -e SPRING_PROFILES_ACTIVE=remote \
  viso-mcp-server

Khi nào nên sử dụng hồ sơ từ xa:

Khi triển khai máy chủ MCP lên máy chủ từ xa hoặc môi trường đám mây
Khi máy khách sẽ kết nối qua HTTP/SSE thay vì stdio trực tiếp
Khi bạn cần ghi nhật ký và giám sát nâng cao cho triển khai phân tán
Khi tích hợp với trợ lý AI dựa trên web yêu cầu giao tiếp SSE

Đối với phát triển cục bộ và giao tiếp stdio trực tiếp, hãy sử dụng hồ sơ mặc định (không cần chỉ định hồ sơ).

Cài đặt

Cài đặt nhanh

Nhấp vào một trong các nút bên dưới để cài đặt VISO MCP Server trong VS Code:

Thiết lập thủ công với VS Code

Thêm khối JSON sau vào tệp Cài đặt Người dùng (JSON) của bạn trong VS Code. Bạn có thể thực hiện việc này bằng cách nhấn Ctrl + Shift + P và nhập Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "viso_baseurl",
        "description": "VISO TRUST API Base URL",
        "default": "https://app.visotrust.com"
      },
      {
        "type": "promptString",
        "id": "viso_token",
        "description": "VISO TRUST API Token",
        "password": true
      }
    ],
    "servers": {
      "viso-mcp": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "VISOTRUST_API_TOKEN",
          "-e",
          "VISOTRUST_API_BASEURL",
          "visotrustai/viso-mcp-server:latest"
        ],
        "env": {
          "VISOTRUST_API_BASEURL": "${input:viso_baseurl}",
          "VISOTRUST_API_TOKEN": "${input:viso_token}"
        }
      }
    }
  }
}

Tùy chọn, bạn có thể thêm một ví dụ tương tự (tức là không có khóa mcp) vào tệp có tên .vscode/mcp.json trong không gian làm việc của bạn. Điều này sẽ cho phép bạn chia sẻ cấu hình với người khác.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "viso_baseurl",
      "description": "VISO TRUST API Base URL",
      "default": "https://app.visotrust.com"
    },
    {
      "type": "promptString",
      "id": "viso_token",
      "description": "VISO TRUST API Token",
      "password": true
    }
  ],
  "servers": {
    "viso-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VISOTRUST_API_TOKEN",
        "-e",
        "VISOTRUST_API_BASEURL",
        "visotrustai/viso-mcp-server:latest"
      ],
      "env": {
        "VISOTRUST_API_BASEURL": "${input:viso_baseurl}",
        "VISOTRUST_API_TOKEN": "${input:viso_token}"
      }
    }
  }
}

Sử dụng với Claude Desktop và các Máy khách MCP khác

Cấu hình Docker

{
    "mcpServers": {
        "viso-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e", "VISOTRUST_API_TOKEN",
                "-e", "VISOTRUST_API_BASEURL",
                "visotrustai/viso-mcp-server:latest"
            ],
            "env": {
                "VISOTRUST_API_TOKEN": "<your-api-token>",
                "VISOTRUST_API_BASEURL": "https://app.visotrust.com"
            }
        }
    }
}

Cấu hình Java

{
    "mcpServers": {
        "viso-mcp": {
            "command": "java",
            "args": [
                "-jar",
                "viso-mcp-server-<version>.jar",
                "--port",
                "8080",
                "--host",
                "localhost"
            ],
            "env": {
                "JAVA_TOOL_OPTIONS": "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005",
                "VISOTRUST_API_TOKEN": "<your-api-token>",
                "VISOTRUST_API_BASEURL": "https://app.visotrust.com"
            }
        }
    }
}

Lưu ý: Biến môi trường JAVA_TOOL_OPTIONS được sử dụng để đặt các tùy chọn JVM cho gỡ lỗi từ xa. Địa chỉ và cổng có thể được thay đổi khi cần.

💻 Phát triển

Thiết lập Docker

Xây dựng Docker Image

docker build -t viso-mcp-server .

Chạy Docker Container

docker run -i --rm -e VISOTRUST_API_TOKEN=<your-api-token> viso-mcp-server

Gỡ lỗi

Cài đặt MCP Inspector

npm -g install @modelcontextprotocol/inspector

Chạy MCP Inspector để kiểm thử

Xây dựng tệp Jar của MCP Server

./gradlew bootJar

Chạy MCP Inspector

npx @modelcontextprotocol/inspector \
    -e JAVA_TOOL_OPTIONS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=\*:5005 \
    -e VISOTRUST_API_TOKEN=<your-api-token> \
    java -jar build/libs/viso-mcp-server-<version>.jar \
    --port 8080 --host localhost

Thay thế <version> bằng phiên bản hiện tại của dự án (ví dụ: 1.0.0 hoặc phiên bản từ bản phát hành mới nhất).

Pipeline CI/CD

Dự án này sử dụng GitHub Actions để tích hợp liên tục và triển khai liên tục. Quy trình làm việc bao gồm các công việc sau:

Lint

Kiểm tra định dạng mã bằng Spotless:

./gradlew spotlessCheck

Build

Xây dựng ứng dụng và tạo tệp JAR:

./gradlew build

Publish

Khi một bản phát hành mới được tạo:

Cập nhật phiên bản dự án trong build.gradle để khớp với thẻ phát hành
Tải tệp JAR lên bản phát hành GitHub với phiên bản từ thẻ phát hành
Xây dựng và đẩy Docker image lên Docker Hub với các thẻ:
- latest
- Thẻ phát hành (ví dụ: v1.0.0)

Bí mật cần thiết để Xuất bản

Để kích hoạt xuất bản lên Docker Hub, hãy thêm các bí mật này vào kho lưu trữ GitHub của bạn:

DOCKERHUB_USERNAME: Tên người dùng Docker Hub của bạn
DOCKERHUB_TOKEN: Token truy cập Docker Hub của bạn

🛠️ Công cụ

Phần này cung cấp tài liệu cho các công cụ được hiển thị bởi VISO MCP Server. Mỗi công cụ có một mục đích cụ thể, tham số đầu vào và định dạng đầu ra.

Đánh giá

`get_assessment` - Lấy đánh giá theo ID của nó

id: ID đánh giá (số, bắt buộc)

Trả về thông tin chi tiết về một đánh giá cụ thể.

`get_assessment_summary` - Lấy tóm tắt cho đánh giá theo ID của nó

id: ID đánh giá (số, bắt buộc)

Trả về chi tiết tóm tắt cho một đánh giá cụ thể.

`create_assessment` - Bắt đầu đánh giá cho một mối quan hệ hiện có

relationshipId: ID của mối quan hệ cần tạo đánh giá (số, bắt buộc)
recipientEmail: Địa chỉ email của người nhận đánh giá (chuỗi, tùy chọn)
recipientFirstName: Tên của người nhận đánh giá (chuỗi, tùy chọn)
recipientLastName: Họ của người nhận đánh giá (chuỗi, tùy chọn)
publicDocumentUrls: URL của các tài liệu công khai để đưa vào đánh giá (mảng chuỗi, tùy chọn)
followupType: Loại theo dõi (enum chuỗi, tùy chọn)
followupRiskThreshold: Ngưỡng mức độ rủi ro kích hoạt theo dõi (enum chuỗi, tùy chọn)
followupTimeline: Mốc thời gian cho các hành động theo dõi (enum chuỗi, tùy chọn)
collectionTimeline: Mốc thời gian để nhà cung cấp hoàn thành nộp đánh giá (enum chuỗi, tùy chọn)
noVendorResponseAction: Hành động cần thực hiện khi nhà cung cấp không phản hồi (enum chuỗi, tùy chọn)
aiProcessingOnly: Chỉ xử lý bằng AI mà không cần xem xét của con người (boolean, tùy chọn)
requestedAuditTypes: Các loại kiểm toán được yêu cầu cho đánh giá này (mảng chuỗi, tùy chọn)

Trả về chi tiết đánh giá đã tạo.

`update_assessment_expiration_date` - Cập nhật thời hạn mà nhà cung cấp phải nộp phản hồi đánh giá của họ

id: ID đánh giá (số, bắt buộc)
expirationDate: Ngày/giờ hết hạn mới, ISO-8601 có độ lệch; phải ở trong tương lai (chuỗi, bắt buộc)

Trả về thông báo xác nhận.

`update_assessment_followup` - Cập nhật cấu hình theo dõi cho một đánh giá

id: ID đánh giá (số, bắt buộc)
followupType: Loại theo dõi (enum chuỗi, bắt buộc)
followupRiskThreshold: Ngưỡng rủi ro tại hoặc trên mức đó sẽ kích hoạt đánh giá theo dõi (enum chuỗi, tùy chọn)
followupTimeline: Mốc thời gian theo dõi (enum chuỗi, tùy chọn)

Trả về thông báo xác nhận.

Nhật ký kiểm toán

`get_user_audit_log_events` - Lấy các sự kiện nhật ký kiểm toán phạm vi người dùng cho tổ chức của bạn

start: Ngày/giờ bắt đầu truy vấn, ISO-8601 có độ lệch (chuỗi, bắt buộc)
end: Ngày/giờ kết thúc truy vấn, ISO-8601 có độ lệch (chuỗi, bắt buộc)
eventTypes: Tập hợp tùy chọn các loại sự kiện để lọc (ví dụ: USER_LOGGED_IN); để trống cho tất cả (mảng chuỗi, tùy chọn)

Trả về danh sách các sự kiện nhật ký kiểm toán người dùng, giới hạn 500 bản ghi.

`get_audit_log_events` - Lấy các sự kiện nhật ký kiểm toán đã lọc (sự kiện người dùng, tổ chức, đánh giá và mối quan hệ)

start: Ngày/giờ bắt đầu truy vấn, ISO-8601 có độ lệch (chuỗi, bắt buộc)
end: Ngày/giờ kết thúc truy vấn, ISO-8601 có độ lệch (chuỗi, bắt buộc)
eventTypes: Tập hợp tùy chọn các loại sự kiện để lọc (ví dụ: ASSESSMENT_COMPLETED, RELATIONSHIP_CREATED); để trống cho tất cả (mảng chuỗi, tùy chọn)

Trả về các bản ghi sự kiện nhật ký kiểm toán đa hình. Mỗi mục có ít nhất auditEventType và dateTime.

Trường hợp kinh doanh

`get_all_business_cases` - Lấy tất cả các trường hợp kinh doanh có sẵn cho tổ chức của bạn

Không yêu cầu tham số.

Trả về danh sách tất cả các trường hợp kinh doanh có sẵn cho tổ chức của bạn.

Loại dữ liệu

`get_all_datatypes` - Lấy tất cả các loại dữ liệu có sẵn cho tổ chức của bạn

Không yêu cầu tham số.

Trả về danh sách tất cả các loại dữ liệu có sẵn cho tổ chức của bạn.

Thư mục nhà cung cấp

`search_vendor_directory` - Tra cứu nhà cung cấp trong thư mục nhà cung cấp VISO TRUST theo URL hoặc tên miền

urlOrDomain: URL hoặc tên miền cần tìm kiếm, ví dụ: example.com (chuỗi, bắt buộc)

Trả về siêu dữ liệu nhà cung cấp cơ bản (tên, trang chủ, mô tả, favicon, các tên miền đã biết).

Mối quan hệ

`get_all_relationships` - Lấy danh sách tất cả các mối quan hệ và chi tiết đánh giá của chúng

Không yêu cầu tham số.

Trả về thông tin về các nhà cung cấp bên thứ ba bao gồm trạng thái đánh giá, mức độ rủi ro và chi tiết liên hệ.

`get_relationship_by_id` - Lấy một mối quan hệ cụ thể và chi tiết đánh giá của nó theo ID

id: ID mối quan hệ (số, bắt buộc)

Trả về thông tin chi tiết về nhà cung cấp bên thứ ba bao gồm trạng thái đánh giá, mức độ rủi ro và chi tiết liên hệ.

`get_relationship_assessment_history` - Lấy lịch sử đánh giá cho một mối quan hệ

id: ID mối quan hệ (số, bắt buộc)

Trả về danh sách các đánh giá liên quan đến mối quan hệ được chỉ định.

`create_relationship` - Tạo mối quan hệ mới với nhà cung cấp bên thứ ba

name: Tên của mối quan hệ/nhà cung cấp (chuỗi, bắt buộc)
homepage: URL trang chủ của nhà cung cấp (chuỗi, bắt buộc)
businessOwnerEmail: Địa chỉ email của chủ sở hữu doanh nghiệp (chuỗi, bắt buộc)
businessOwnerFirstName: Tên của chủ sở hữu doanh nghiệp (chuỗi, tùy chọn)
businessOwnerLastName: Họ của chủ sở hữu doanh nghiệp (chuỗi, tùy chọn)
description: Mô tả về mối quan hệ/nhà cung cấp (chuỗi, tùy chọn)
contextTypes: Danh sách các loại ngữ cảnh kinh doanh cho mối quan hệ này (mảng đối tượng, tùy chọn)
dataTypes: Danh sách các loại dữ liệu được xử lý trong mối quan hệ này (mảng đối tượng, tùy chọn)
tags: Danh sách các thẻ để phân loại mối quan hệ này (mảng chuỗi, tùy chọn)
thirdPartyContact: Chi tiết liên hệ của đại diện nhà cung cấp bên thứ ba (đối tượng, tùy chọn)

Trả về chi tiết mối quan hệ đã tạo.

`create_relationship_by_domain` - Tạo mối quan hệ mới chỉ sử dụng tên miền nhà cung cấp

domain: Tên miền của nhà cung cấp, ví dụ: visotrust.com (chuỗi, bắt buộc)
vendorName: Tên của nhà cung cấp (chuỗi, bắt buộc)
product: Sản phẩm do nhà cung cấp cung cấp (chuỗi, tùy chọn)
description: Mô tả về mối quan hệ nhà cung cấp (chuỗi, tùy chọn)

Trả về chi tiết mối quan hệ đã tạo.

`update_relationship` - Cập nhật mối quan hệ hiện có với nhà cung cấp bên thứ ba

id: ID mối quan hệ (số, bắt buộc)
name: Tên của mối quan hệ/nhà cung cấp (chuỗi, bắt buộc)
homepage: URL trang chủ của nhà cung cấp (chuỗi, tùy chọn)
description: Mô tả về mối quan hệ/nhà cung cấp (chuỗi, tùy chọn)
contextTypes: Danh sách các loại ngữ cảnh kinh doanh (mảng đối tượng, tùy chọn)
dataTypes: Danh sách các loại dữ liệu được xử lý trong mối quan hệ này (mảng đối tượng, tùy chọn)
businessOwnerEmail: Địa chỉ email của chủ sở hữu doanh nghiệp (chuỗi, tùy chọn)
businessOwnerFirstName: Tên của chủ sở hữu doanh nghiệp (chuỗi, tùy chọn)
businessOwnerLastName: Họ của chủ sở hữu doanh nghiệp (chuỗi, tùy chọn)
tags: Danh sách các thẻ (mảng chuỗi, tùy chọn)

Trả về chi tiết mối quan hệ đã cập nhật.

`partially_update_relationship` - Cập nhật một phần mối quan hệ hiện có

Chấp nhận các trường tương tự như update_relationship. Chỉ các trường được cung cấp trong yêu cầu mới được thay đổi; các trường khác được giữ nguyên.

Trả về chi tiết mối quan hệ đã cập nhật.

`search_relationships` - Tìm kiếm mối quan hệ theo tên miền hoặc tên nhà cung cấp

domains: Danh sách tên miền cần tìm kiếm (mảng chuỗi, bắt buộc)
name: Tên của nhà cung cấp/mối quan hệ cần tìm kiếm (chuỗi, bắt buộc)

Trả về danh sách các mối quan hệ phù hợp với chi tiết đánh giá của chúng.

`create_tags` - Tạo thẻ mới để phân loại mối quan hệ

tags: Danh sách tên thẻ cần tạo (mảng chuỗi, bắt buộc)

Trả về danh sách tất cả các thẻ bao gồm cả những thẻ mới được tạo.

`update_third_party_contact` - Cập nhật chi tiết liên hệ cho nhà cung cấp bên thứ ba

relationshipId: ID mối quan hệ (số, bắt buộc)
email: Email liên hệ (chuỗi, bắt buộc)
firstName: Tên liên hệ (chuỗi, bắt buộc)
lastName: Họ liên hệ (chuỗi, bắt buộc)

Trả về chi tiết mối quan hệ đã cập nhật.

`onboard_relationship` - Thiết lập mối quan hệ, tùy chọn kèm tóm tắt phê duyệt và cài đặt quản lý vòng đời

id: ID mối quan hệ (số, bắt buộc)
approvalSummary: Tóm tắt phê duyệt tùy chọn được ghi nhận khi thiết lập (chuỗi, tùy chọn)
lifecycleManagementUpdateRequest: Cài đặt quản lý vòng đời tùy chọn (đối tượng, tùy chọn)
- artifactUpdateSettings.artifactUpdateType: Loại cập nhật hiện vật (enum chuỗi)
- recertificationSettings.recertificationType: Loại tái chứng nhận (enum chuỗi)
- recertificationSettings.recertificationDate: Ngày/giờ tái chứng nhận tiếp theo, ISO-8601 có độ lệch (chuỗi)
- recertificationSettings.reviewFrequency: THREE_YEARS, TWO_YEARS, ANNUAL, SEMIANNUAL, hoặc QUARTERLY (enum chuỗi)

Trả về chi tiết mối quan hệ đã thiết lập.

`offboard_relationship` - Ngừng thiết lập mối quan hệ

id: ID mối quan hệ (số, bắt buộc)

Trả về chi tiết mối quan hệ đã ngừng thiết lập.

`archive_relationship` - Lưu trữ mối quan hệ

id: ID mối quan hệ (số, bắt buộc)

Trả về chi tiết mối quan hệ đã lưu trữ.

Webhooks

`get_all_webhooks` - Lấy tất cả webhooks

Không yêu cầu tham số.

Trả về danh sách tất cả cấu hình webhook.

`get_webhook` - Lấy cấu hình webhook theo id

id: ID webhook (số, bắt buộc)

Trả về chi tiết của một cấu hình webhook cụ thể.

`create_webhook_configuration` - Tạo cấu hình webhook

request: Tham số tạo webhook (đối tượng, bắt buộc)
- url: URL webhook (chuỗi, bắt buộc)
- secret: Bí mật webhook (chuỗi, bắt buộc)
- eventTypes: Các loại sự kiện kích hoạt webhook (mảng chuỗi, bắt buộc)
- serviceType: Loại dịch vụ cho webhook (chuỗi, bắt buộc)

Trả về cấu hình webhook đã tạo.

`update_webhook_configuration` - Cập nhật cấu hình webhook

request: Tham số cập nhật webhook (đối tượng, bắt buộc)
- id: ID webhook (số, bắt buộc)
- url: URL webhook (chuỗi, tùy chọn)
- secret: Bí mật webhook (chuỗi, tùy chọn)
- eventTypes: Các loại sự kiện kích hoạt webhook (mảng chuỗi, tùy chọn)
- serviceType: Loại dịch vụ cho webhook (chuỗi, tùy chọn)

Trả về cấu hình webhook đã cập nhật.

`delete_webhook_configuration` - Xóa cấu hình webhook

id: ID webhook (số, bắt buộc)

Xóa cấu hình webhook được chỉ định.

Báo cáo Tình báo

`create_bitsight_intelligence_report` - Tạo báo cáo tình báo BitSight mới

request: Tham số báo cáo BitSight (đối tượng, bắt buộc)
- vendorDomain: Tên miền chính của nhà cung cấp (chuỗi, bắt buộc)
- reportDate: Ngày/giờ báo cáo được tạo (chuỗi ISO 8601, bắt buộc)
- link: Liên kết tùy chọn đến giao diện người dùng của nhà cung cấp (chuỗi, tùy chọn)
- guid: GUID BitSight cho thực thể (chuỗi, bắt buộc)
- customId: Định danh tùy chỉnh từ BitSight (chuỗi, tùy chọn)
- name: Tên hiển thị của thực thể BitSight (chuỗi, tùy chọn)
- description: Mô tả của thực thể BitSight (chuỗi, tùy chọn)
- primaryDomain: Tên miền chính cho thực thể BitSight (chuỗi, tùy chọn)
- ratingRange: Phạm vi xếp hạng BitSight (chuỗi, tùy chọn)
- ratingColor: Màu xếp hạng BitSight (chuỗi, tùy chọn)
- confidence: Mức độ tin cậy của xếp hạng BitSight (chuỗi, tùy chọn)

Trả về báo cáo tình báo đã tạo.

`create_security_scorecard_intelligence_report` - Tạo báo cáo tình báo SecurityScorecard mới

request: Tham số báo cáo SecurityScorecard (đối tượng, bắt buộc)
- vendorDomain: Tên miền chính của nhà cung cấp (chuỗi, bắt buộc)
- reportDate: Ngày/giờ báo cáo được tạo (chuỗi ISO 8601, bắt buộc)
- link: Liên kết tùy chọn đến giao diện người dùng của nhà cung cấp (chuỗi, tùy chọn)
- grade: Điểm chữ SecurityScorecard (chuỗi, bắt buộc)
- domain: Tên miền liên kết với thực thể scorecard (chuỗi, tùy chọn)
- score: Điểm số từ SecurityScorecard (số, tùy chọn)

Trả về báo cáo tình báo đã tạo.

`create_recorded_future_intelligence_report` - Tạo báo cáo tình báo Recorded Future mới

request: Tham số báo cáo Recorded Future (đối tượng, bắt buộc)
- vendorDomain: Tên miền chính của nhà cung cấp (chuỗi, bắt buộc)
- reportDate: Ngày/giờ báo cáo được tạo (chuỗi ISO 8601, bắt buộc)
- entityType: Loại thực thể Recorded Future, ví dụ: Company (chuỗi, bắt buộc)
- entity: Định danh thực thể Recorded Future (chuỗi, bắt buộc)
- riskScore: Điểm rủi ro số (số, bắt buộc)
- riskLevel: Nhãn mức độ rủi ro, ví dụ: Critical/High/Medium/Low (chuỗi, bắt buộc)
- link: Liên kết tùy chọn đến báo cáo trong giao diện người dùng của nhà cung cấp (chuỗi, tùy chọn)
- firstSeen: Ngày quan sát sớm nhất cho thực thể, ISO 8601 (chuỗi, tùy chọn)
- lastSeen: Ngày quan sát gần đây nhất cho thực thể, ISO 8601 (chuỗi, tùy chọn)
- triggeredRuleCount: Số lượng quy tắc Recorded Future đã kích hoạt (số, tùy chọn)
- maxRuleCount: Số lượng quy tắc Recorded Future tối đa được đánh giá (số, tùy chọn)
- summary: Văn bản tóm tắt tùy chọn từ Recorded Future (chuỗi, tùy chọn)
- criticalityLabel: Nhãn mức độ nghiêm trọng Recorded Future cho thực thể (chuỗi, tùy chọn)

Trả về báo cáo tình báo đã tạo.

`get_intelligence_reports_by_vendor` - Lấy tất cả báo cáo tình báo cho một nhà cung cấp

vendorDomain: Tên miền chính của nhà cung cấp (chuỗi, bắt buộc)

Trả về danh sách báo cáo tình báo cho nhà cung cấp được chỉ định.

`get_latest_intelligence_report` - Lấy báo cáo tình báo mới nhất cho một nhà cung cấp từ một nguồn cụ thể

vendorDomain: Tên miền chính của nhà cung cấp (chuỗi, bắt buộc)
source: Nhà cung cấp tình báo (enum chuỗi: BITSIGHT, SECURITY_SCORECARD, hoặc RECORDED_FUTURE, bắt buộc)

Trả về báo cáo tình báo mới nhất cho nhà cung cấp và nguồn được chỉ định.

Người dùng

`get_all_users` - Lấy tất cả người dùng trong tổ chức của bạn

page: Trang kết quả cần lấy (số, tùy chọn; mặc định 0)
size: Số bản ghi mỗi trang (số, tùy chọn; mặc định 20)
sort: Tiêu chí sắp xếp theo định dạng: thuộc tính(,asc|desc) (chuỗi, tùy chọn)

Trả về danh sách người dùng được phân trang.

`get_user_by_email` - Lấy người dùng theo email

email: Địa chỉ email của người dùng (chuỗi, bắt buộc)

Trả về chi tiết người dùng.

`create_user` - Tạo người dùng mới

request: Tham số tạo người dùng (đối tượng, bắt buộc)
- email: Địa chỉ email của người dùng mới (chuỗi, bắt buộc)
- firstName: Tên của người dùng mới (chuỗi, bắt buộc)
- lastName: Họ của người dùng mới (chuỗi, bắt buộc)

Trả về người dùng đã tạo.

Định dạng Mã nguồn

Dự án này sử dụng Spotless với Google Java Format để định dạng mã nguồn. Một hook pre-commit được tự động thiết lập để đảm bảo phong cách mã nguồn nhất quán.

Thiết lập

Sau khi sao chép kho lưu trữ, hook pre-commit sẽ được tự động thiết lập khi bạn chạy bất kỳ lệnh Gradle nào.

Định dạng Thủ công

Để định dạng thủ công tất cả các tệp:

./gradlew spotlessApply

Để kiểm tra xem các tệp đã được định dạng đúng chưa:

./gradlew spotlessCheck

Nếu hook pre-commit từ chối commit của bạn do vấn đề định dạng, chỉ cần chạy ./gradlew spotlessApply để sửa định dạng và sau đó thử commit lại.

Giấy phép

Dự án này được cấp phép theo Giấy phép MIT - xem tệp LICENSE để biết chi tiết.

VISO TRUST MCP Server

Tài liệu

VISO TRUST MCP Server

Yêu cầu

Cấu hình

Cấu hình API VISO TRUST

Hồ sơ ứng dụng

Hồ sơ từ xa

Cài đặt

Cài đặt nhanh

Thiết lập thủ công với VS Code

Sử dụng với Claude Desktop và các Máy khách MCP khác

Cấu hình Docker

Cấu hình Java

💻 Phát triển

Thiết lập Docker

Xây dựng Docker Image

Chạy Docker Container

Gỡ lỗi

Cài đặt MCP Inspector

Chạy MCP Inspector để kiểm thử

Pipeline CI/CD

Lint

Build

Publish

Bí mật cần thiết để Xuất bản

🛠️ Công cụ

Đánh giá

get_assessment - Lấy đánh giá theo ID của nó

get_assessment_summary - Lấy tóm tắt cho đánh giá theo ID của nó

create_assessment - Bắt đầu đánh giá cho một mối quan hệ hiện có

update_assessment_expiration_date - Cập nhật thời hạn mà nhà cung cấp phải nộp phản hồi đánh giá của họ

update_assessment_followup - Cập nhật cấu hình theo dõi cho một đánh giá

Nhật ký kiểm toán

get_user_audit_log_events - Lấy các sự kiện nhật ký kiểm toán phạm vi người dùng cho tổ chức của bạn

get_audit_log_events - Lấy các sự kiện nhật ký kiểm toán đã lọc (sự kiện người dùng, tổ chức, đánh giá và mối quan hệ)

Trường hợp kinh doanh

get_all_business_cases - Lấy tất cả các trường hợp kinh doanh có sẵn cho tổ chức của bạn

Loại dữ liệu

get_all_datatypes - Lấy tất cả các loại dữ liệu có sẵn cho tổ chức của bạn

Thư mục nhà cung cấp

search_vendor_directory - Tra cứu nhà cung cấp trong thư mục nhà cung cấp VISO TRUST theo URL hoặc tên miền

Mối quan hệ

get_all_relationships - Lấy danh sách tất cả các mối quan hệ và chi tiết đánh giá của chúng

get_relationship_by_id - Lấy một mối quan hệ cụ thể và chi tiết đánh giá của nó theo ID

get_relationship_assessment_history - Lấy lịch sử đánh giá cho một mối quan hệ

create_relationship - Tạo mối quan hệ mới với nhà cung cấp bên thứ ba

create_relationship_by_domain - Tạo mối quan hệ mới chỉ sử dụng tên miền nhà cung cấp

update_relationship - Cập nhật mối quan hệ hiện có với nhà cung cấp bên thứ ba

partially_update_relationship - Cập nhật một phần mối quan hệ hiện có

search_relationships - Tìm kiếm mối quan hệ theo tên miền hoặc tên nhà cung cấp

create_tags - Tạo thẻ mới để phân loại mối quan hệ

update_third_party_contact - Cập nhật chi tiết liên hệ cho nhà cung cấp bên thứ ba

onboard_relationship - Thiết lập mối quan hệ, tùy chọn kèm tóm tắt phê duyệt và cài đặt quản lý vòng đời

offboard_relationship - Ngừng thiết lập mối quan hệ

archive_relationship - Lưu trữ mối quan hệ

Webhooks

get_all_webhooks - Lấy tất cả webhooks

get_webhook - Lấy cấu hình webhook theo id

create_webhook_configuration - Tạo cấu hình webhook

update_webhook_configuration - Cập nhật cấu hình webhook

delete_webhook_configuration - Xóa cấu hình webhook

Báo cáo Tình báo

create_bitsight_intelligence_report - Tạo báo cáo tình báo BitSight mới

create_security_scorecard_intelligence_report - Tạo báo cáo tình báo SecurityScorecard mới

create_recorded_future_intelligence_report - Tạo báo cáo tình báo Recorded Future mới

get_intelligence_reports_by_vendor - Lấy tất cả báo cáo tình báo cho một nhà cung cấp

get_latest_intelligence_report - Lấy báo cáo tình báo mới nhất cho một nhà cung cấp từ một nguồn cụ thể

Người dùng

get_all_users - Lấy tất cả người dùng trong tổ chức của bạn

get_user_by_email - Lấy người dùng theo email

create_user - Tạo người dùng mới

Định dạng Mã nguồn

Thiết lập

Định dạng Thủ công

Giấy phép

`get_assessment` - Lấy đánh giá theo ID của nó

`get_assessment_summary` - Lấy tóm tắt cho đánh giá theo ID của nó

`create_assessment` - Bắt đầu đánh giá cho một mối quan hệ hiện có

`update_assessment_expiration_date` - Cập nhật thời hạn mà nhà cung cấp phải nộp phản hồi đánh giá của họ

`update_assessment_followup` - Cập nhật cấu hình theo dõi cho một đánh giá

`get_user_audit_log_events` - Lấy các sự kiện nhật ký kiểm toán phạm vi người dùng cho tổ chức của bạn

`get_audit_log_events` - Lấy các sự kiện nhật ký kiểm toán đã lọc (sự kiện người dùng, tổ chức, đánh giá và mối quan hệ)

`get_all_business_cases` - Lấy tất cả các trường hợp kinh doanh có sẵn cho tổ chức của bạn

`get_all_datatypes` - Lấy tất cả các loại dữ liệu có sẵn cho tổ chức của bạn

`search_vendor_directory` - Tra cứu nhà cung cấp trong thư mục nhà cung cấp VISO TRUST theo URL hoặc tên miền

`get_all_relationships` - Lấy danh sách tất cả các mối quan hệ và chi tiết đánh giá của chúng

`get_relationship_by_id` - Lấy một mối quan hệ cụ thể và chi tiết đánh giá của nó theo ID

`get_relationship_assessment_history` - Lấy lịch sử đánh giá cho một mối quan hệ

`create_relationship` - Tạo mối quan hệ mới với nhà cung cấp bên thứ ba

`create_relationship_by_domain` - Tạo mối quan hệ mới chỉ sử dụng tên miền nhà cung cấp

`update_relationship` - Cập nhật mối quan hệ hiện có với nhà cung cấp bên thứ ba

`partially_update_relationship` - Cập nhật một phần mối quan hệ hiện có

`search_relationships` - Tìm kiếm mối quan hệ theo tên miền hoặc tên nhà cung cấp

`create_tags` - Tạo thẻ mới để phân loại mối quan hệ

`update_third_party_contact` - Cập nhật chi tiết liên hệ cho nhà cung cấp bên thứ ba

`onboard_relationship` - Thiết lập mối quan hệ, tùy chọn kèm tóm tắt phê duyệt và cài đặt quản lý vòng đời

`offboard_relationship` - Ngừng thiết lập mối quan hệ

`archive_relationship` - Lưu trữ mối quan hệ

`get_all_webhooks` - Lấy tất cả webhooks

`get_webhook` - Lấy cấu hình webhook theo id

`create_webhook_configuration` - Tạo cấu hình webhook

`update_webhook_configuration` - Cập nhật cấu hình webhook

`delete_webhook_configuration` - Xóa cấu hình webhook

`create_bitsight_intelligence_report` - Tạo báo cáo tình báo BitSight mới

`create_security_scorecard_intelligence_report` - Tạo báo cáo tình báo SecurityScorecard mới

`create_recorded_future_intelligence_report` - Tạo báo cáo tình báo Recorded Future mới

`get_intelligence_reports_by_vendor` - Lấy tất cả báo cáo tình báo cho một nhà cung cấp

`get_latest_intelligence_report` - Lấy báo cáo tình báo mới nhất cho một nhà cung cấp từ một nguồn cụ thể

`get_all_users` - Lấy tất cả người dùng trong tổ chức của bạn

`get_user_by_email` - Lấy người dùng theo email

`create_user` - Tạo người dùng mới