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.3.tar.gz (11.6 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.3-py3-none-any.whl (12.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agenticwerx_mcp_client-1.0.3.tar.gz
  • Upload date:
  • Size: 11.6 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.3.tar.gz
Algorithm Hash digest
SHA256 298d87f8f7ce36bf62ee896d92fab589e31e5cdd063e06bdc4c75fcd575a5159
MD5 2f10c405b37a729cb3194857af33cff3
BLAKE2b-256 af84baaecd41529fefae93e3a8121c71003f07582d5d90254b989bcaa7828897

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agenticwerx_mcp_client-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3b6e2857d074bc1e665e74db17a566a5381af6f07ceb5101c46bbfc7bbb5ed47
MD5 608002e22f7880f89080cf9c9fec3999
BLAKE2b-256 cdedf73b1cc0839458b01413560a56480efc2c31b441b815eeb4ebd335b3293a

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