Metadata-Version: 2.4
Name: towardsagi-mcp-client
Version: 1.0.0
Summary: Minimal MCP Client for TowardsMCP Server
Author-email: "TowardsAGI.AI UK Ltd" <support@towardsagi.ai>, Mansoor Pasha Iqbal <mansoor.pasha@towardsagi.ai>
License: Proprietary
Keywords: mcp,model-context-protocol,bridge,towards-agi,claude
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Requires-Dist: mcp>=1.0.0
Dynamic: license-file

# TowardsMCP Client

A minimal MCP (Model Context Protocol) client package for connecting Claude, Claude-VSCode, and other MCP clients to TowardsMCP Server resources.

## Installation

```bash
# Install from PyPI
pip install towardsagi-mcp-client

# Or install from source
pip install .
```

## Usage

This package is designed to be used directly in MCP configurations for Claude Desktop, Claude VSCode Extension, Cursor, or other MCP clients.

### Example Configuration

Your MCP configuration (mcp.json) should already be correctly set up:

```json
{
  "mcpServers": {
    "towardsmcp-MyResource": {
      "command": "python3",
      "args": [
        "-m",
        "towardsagi_mcp_server.tools.toolcall"
      ],
      "env": {
        "TOWARDSMCP_API_KEY": "tmcp_YOUR_API_KEY",
        "TOWARDSMCP_SERVER_URL": "https://your-server-url.com/",
        "TOWARDSMCP_RESOURCE": "MyResource"
      }
    }
  }
}
```

### Environment Variables

The client requires the following environment variables:

- `TOWARDSMCP_API_KEY`: Your TowardsMCP API key for authentication
- `TOWARDSMCP_SERVER_URL`: URL of your TowardsMCP server
- `TOWARDSMCP_RESOURCE`: Name of the resource to connect to

## Troubleshooting

If you're experiencing a "module not found" error when using your MCP configuration, simply install this package:

```bash
pip install towardsagi-mcp-client
```

After installing this package, your existing MCP configuration should work without any changes.

## License

Proprietary - TowardsAGI.AI UK Ltd

## Author

Mansoor Pasha Iqbal (mansoor.pasha@towardsagi.ai) 
