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.1.tar.gz (11.0 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.1-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agenticwerx_mcp_client-1.0.1.tar.gz
  • Upload date:
  • Size: 11.0 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.1.tar.gz
Algorithm Hash digest
SHA256 22e175c98ea16548a27e195c189c88d02c296e0e91e5ada3b94f86de996a13ea
MD5 6a1cd43746c83c1102d084fad6db4729
BLAKE2b-256 3cdc51c469dd6b5653b4c86a2b2ad5b822efa67b137981198041930280398710

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agenticwerx_mcp_client-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4f7c802448e63090ba46aa616fa44092cdbeca698ddfbbc546f5c1dd42d2e118
MD5 6f63f32b2572b132529940a7609eb661
BLAKE2b-256 354abc810d01d10ec0d0e6536693242dc60edf5f2ba1621110e1650659116dab

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