@impart-security/impart-mcp v0.1.3

Impart MCP Tools

A Model Context Protocol (MCP) implementation for interacting with Impart's API. This package provides a set of tools for managing and interacting with Impart's security features through MCP.

Features

• Rules Script Management
• API Bindings Management
• Endpoint Inventory
• Tag Management
• Observed Hosts Monitoring
• Specification Management
• List and Label Management
• Inspector Management

Prerequisites

You'll need to set up the following environment variables:

• IMPART_AUTH_TOKEN - Your Impart authentication token

Available Tools

Rules Scripts

• list_rules_scripts - Get a list of rules scripts
• get_rules_script - Get details of a specific rules script
• create_rules_script - Create a new rules script
• update_rules_script - Update an existing rules script
• validate_rules_script - Validate a rules script
• write_rule_script - Generate a rule script using Sparkle API

API Bindings

• list_api_bindings - Get a list of API bindings
• create_api_binding - Create a new API binding

Endpoints and Specs

• list_endpoints - Get an inventory of endpoints
• list_specs - Get a list of specs
• get_spec - Get details of a specific spec

Tags and Metrics

• list_tags - Get a list of tags
• get_tag_metrics - Get timeseries metrics for tags

Observed Hosts

• list_observed_hosts - Get a list of observed hosts
• get_observed_host - Get details of a specific observed host

Lists and Labels

• list_lists - Get a list of lists
• get_list_items - Get items from a specific list
• create_list - Create a new list
• update_list_items - Update items in a list
• create_label - Create a new label
• list_labels - Get a list of labels

Inspectors

• list_inspectors - Get a list of inspectors

Connecting to MCP Clients

Claude Desktop

To use Impart MCP with Claude Desktop, you'll need to configure the MCP server in Claude's configuration file. Here's how:

1. Open or create your Claude Desktop configuration file:

   # MacOS
   vim ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # Windows
   # %AppData%\Claude\claude_desktop_config.json

2. Add the Impart MCP server configuration:

   {
       "mcpServers": {
           "impart": {
               "command": "npx",
               "args": [
                   "-y",
                   "@impart-security/impart-mcp"
               ],
               "env": {
                   "IMPART_AUTH_TOKEN": "your_auth_token"
               }
           }
       }
   }

Make sure to update the environment variables with your Impart credentials.

3. Restart Claude Desktop for the changes to take effect.

The Impart MCP tools will now be available in your Claude Desktop conversations. You can use them to manage rules scripts, API bindings, endpoints, and more directly from Claude.

Cursor

To use Impart MCP with Cursor, create or edit the mcp.json file in your Cursor configuration directory:

# MacOS
vim ~/Library/Application\ Support/Cursor/mcp.json

# Windows
# %AppData%\Cursor\mcp.json

Add the Impart MCP server configuration:

{
  "mcpServers": {
    "impart": {
      "command": "npx",
      "args": [
        "-y",
        "@impart-security/impart-mcp"
      ],
      "env": {
        "IMPART_AUTH_TOKEN": "your_auth_token"
      }
    }
  }
}

Make sure to update the environment variables with your Impart credentials.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

ISC

Support

For support, please contact Impart support or open an issue on GitHub.