chanty

This MCP server provides an integration bridge between Chanty and MCP (Model Context Protocol) enabled applications. It exposes a Chanty-specific MCP server that covers the Chanty API surface, supports multiple authentication methods, and includes error handling and retry logic with asynchronous operation for better performance. You can deploy this server to act as a middleware layer, translating MCP requests into Chanty API calls and returning MCP-compliant responses to clients. The server is designed to work with Python and relies on the chanty_mcp module installed from PyPI.

To use it, install the package, set up your environment variables (such as your Chanty API credentials and base URL), and run the module so the MCP server starts listening for requests. Consumers can then connect to this MCP server using the MCP protocol, leveraging Chanty functionality like messaging, user management, and integration with GenAI applications.

Prerequisites:

• Python 3.8+ (recommended 3.9 or newer)
• pip (Python package manager)
• Internet access to install dependencies

1. Optional: Create and activate a virtual environment

• On macOS/Linux:
  • python3 -m venv venv
  • source venv/bin/activate
• On Windows:
  • python -m venv venv
  • .\venv\Scripts\activate

2. Install the Chanty MCP server package from PyPI

• pip install chanty-mcp-server

3. Alternatively, install from source (if you have the repository cloned)

• git clone https://github.com/LokiMCPUniverse/chanty-mcp-server.git
• cd chanty-mcp-server
• pip install -e .

4. Prepare environment variables

• Create a .env file or export variables in your shell. Required values typically include:
  • CHANTY_API_KEY: Your Chanty API key
  • CHANTY_BASE_URL: Base URL for Chanty API
  • PYTHONUNBUFFERED: 1 (optional, for unbuffered output)

5. Run the MCP server

• python -m chanty_mcp (This will start the server using the module entry point as configured in the MCP setup.)

6. Verify operation

• Check logs for startup messages indicating the server is listening for MCP requests.
• Use an MCP client to connect to the server and verify Chanty-related MCP capabilities.

Tips and potential issues:

• Ensure your CHANTY_API_KEY and CHANTY_BASE_URL are correct; misconfiguration will lead to authentication or API errors.
• If you see connection issues, verify network access to Chanty endpoints and that the base URL is accessible from your deployment environment.
• Use a virtual environment to avoid dependency conflicts with system Python.
• Enable verbose logging during initial setup to troubleshoot MCP requests and responses.
• If upgrading from a previous version, review changelogs for any breaking changes in the MCP interface or environment variables.
• For production deployments, consider adding rate-limiting, proper error handling retries, and secure storage for API keys (e.g., environment secrets).