Skip to main content

Simple MCP client that connects to your AgenticWerx MCP server to retrieve rules

Project description

AgenticWerx MCP Client

PyPI version Python Support License: MIT

A Model Context Protocol (MCP) client that connects to the AgenticWerx Lambda MCP server using JSON-RPC 2.0 protocol to provide code analysis and rule management capabilities.

🚀 Quick Start

For IDE Users

Add this configuration to your MCP-compatible IDE (Kiro, Amazon Q Developer, etc.):

{
  "mcpServers": {
    "agenticwerx": {
      "command": "uvx",
      "args": ["agenticwerx-mcp-client@latest", "--api-key", "${AGENTICWERX_API_KEY}"],
      "env": {
        "AGENTICWERX_API_KEY": "your-api-key-here"
      }
    }
  }
}

Get Your API Key

  1. Visit AgenticWerx Dashboard
  2. Navigate to API Keys section
  3. Create a new API key
  4. Copy the key to your MCP configuration

🛠️ Available Tools

The AgenticWerx MCP client provides a simple tool for code analysis:

analyze

Analyze code using AgenticWerx rules from the server.

Parameters:

  • packageId (optional): Specific package ID to use rules from a specific package

Example:

{
  "tool": "analyze",
  "packageId": "stripe-integration-excellence-pack"
}

The tool connects to AgenticWerx services and retrieves the rules, which are then processed and returned to your IDE.

🔗 Simple Connection

This client acts as a simple bridge between your IDE and AgenticWerx services. It retrieves rules and passes them back to your IDE for code analysis.

🔧 Installation Methods

Method 1: UVX (Recommended)

No installation needed! Your IDE will automatically download and run the client:

uvx agenticwerx-mcp-client@latest --api-key your_key_here

Method 2: pip install

pip install agenticwerx-mcp-client
agenticwerx-mcp-client --api-key your_key_here

Method 3: From Source

git clone https://github.com/agenticwerx/mcp-client.git
cd mcp-client
pip install -e .
agenticwerx-mcp-client --api-key your_key_here

📋 IDE Configuration Examples

Kiro IDE

{
  "mcpServers": {
    "agenticwerx": {
      "command": "uvx",
      "args": ["agenticwerx-mcp-client@latest", "--api-key", "${AGENTICWERX_API_KEY}"],
      "env": {
        "AGENTICWERX_API_KEY": "your-api-key-here"
      }
    }
  }
}

Amazon Q Developer

{
  "mcpServers": {
    "agenticwerx": {
      "command": "uvx",
      "args": ["agenticwerx-mcp-client@latest", "--api-key", "${AGENTICWERX_API_KEY}"],
      "env": {
        "AGENTICWERX_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code (with MCP extension)

{
  "mcp.servers": {
    "agenticwerx": {
      "command": "uvx",
      "args": ["agenticwerx-mcp-client@latest", "--api-key", "${AGENTICWERX_API_KEY}"],
      "env": {
        "AGENTICWERX_API_KEY": "your-api-key-here"
      }
    }
  }
}

🔒 Security & Privacy

  • API Key Security: Your API key is only used to authenticate with AgenticWerx services
  • Code Privacy: Code analysis happens securely through encrypted connections
  • No Data Storage: Your code is analyzed in real-time and not stored on our servers
  • Local Processing: The MCP client runs locally on your machine

🚀 Features

  • Simple Connection: Connects your IDE to AgenticWerx services
  • Rule Retrieval: Fetches rules from the server
  • MCP Compatible: Works with any MCP-compatible IDE
  • Zero Configuration: Just add your API key
  • Lightweight: Minimal overhead, just passes data through

📊 Example Output

{
  "tool": "analyze",
  "packageId": "stripe-integration-excellence-pack",
  "rules": {
    "rules": [
      {
        "id": "rule-1",
        "name": "Security Rule",
        "description": "Prevents security vulnerabilities",
        "pattern": "eval\\(",
        "message": "Avoid using eval() as it can lead to code injection"
      }
    ],
    "metadata": {
      "package_name": "Security Rules",
      "version": "1.0.0",
      "total_rules": 1
    }
  }
}

🛠️ Technical Requirements

Runtime Requirements

  • Python 3.8+
  • httpx >= 0.25.0
  • mcp >= 1.0.0
  • pydantic >= 2.0.0

Installation

# Via uvx (recommended)
uvx agenticwerx-mcp-client@latest --api-key your_key_here

# Via pip
pip install agenticwerx-mcp-client

📚 Documentation

🆘 Support

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Note: This is a proprietary package developed and maintained exclusively by AgenticWerx. We do not accept external contributions at this time.

🔄 Changelog

v1.0.0 (2025-01-XX)

  • Initial release
  • Full MCP protocol support
  • Rule retrieval tools
  • Multi-language support
  • Real-time code feedback

Built with ❤️ by the AgenticWerx Team

Making code quality accessible to every developer, in every IDE, for every language.

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

agenticwerx_mcp_client-1.0.0.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agenticwerx_mcp_client-1.0.0-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

Details for the file agenticwerx_mcp_client-1.0.0.tar.gz.

File metadata

  • Download URL: agenticwerx_mcp_client-1.0.0.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for agenticwerx_mcp_client-1.0.0.tar.gz
Algorithm Hash digest
SHA256 b2f3ec1c5d4132b953dc59d3e2d784ef915432e7e84d3f7dadaa23ce0fc3b61f
MD5 dc996c7df34e8ac598f482013200e303
BLAKE2b-256 cb9fb837aca14a8de2c88b2ceca0be72c3d5c21bc4a8e2aab5e264e65543a65e

See more details on using hashes here.

File details

Details for the file agenticwerx_mcp_client-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agenticwerx_mcp_client-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3d454c7f30525f47d718477e252f32da5369175137927071e3547070a56f4e29
MD5 0217581ed5f20181253acd38dc49c5a0
BLAKE2b-256 7a295f67b2ed689aca2a202268ee057a826b46e30af2c674e791e619e399eb9b

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