Skip to content

Clix MCP Server enables AI agents to provide real-time, trusted Clix documentation and SDK code examples for seamless integrations.

License

Notifications You must be signed in to change notification settings

clix-so/clix-mcp-server

Repository files navigation

Clix MCP Server

npm version npm downloads License

Clix MCP Server enables AI agents to deliver real‑time, trustworthy Clix documentation and SDK code examples for seamless integrations right inside any MCP‑compatible client.

Clix MCP Server implements the Model Context Protocol (MCP), an open standard for enabling LLMs to interact with external tools and data.

Key capabilities:

  • Documentation Search — Search Clix docs (user guides, API reference, troubleshooting, best practices) with semantic ranking.
  • SDK Search — Explore Clix SDKs (iOS, Android, Flutter, React Native) and implementation examples. Discover SDK symbols and retrieve production‑ready snippets.

Installation

Prerequisites

  • Node.js >= 18

Quick Start

Install Clix MCP Server:

npm i -g @clix-so/clix-mcp-server@latest

Create or update the .mcp.json at your project root (or the configuration location your MCP client uses). Using npx ensures you always run the latest published version:

Shared MCP configuration

Add Clix with:

{
  "mcpServers": {
    "clix-mcp-server": {
      "command": "npx",
      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
    }
  }
}

Place this in your client’s MCP config (e.g., VS Code extension settings, ~/.cursor/mcp.json, or your Copilot client’s MCP settings).

Claude Code Configuration

Open your terminal to access the Claude Code CLI. Run the following command to register the Clix MCP Server.

claude mcp add --transport stdio clix-mcp-server -- npx -y @clix-so/clix-mcp-server@latest

Codex Configuration

Open ~/.codex/config.toml. Add the following configuration and restart the Codex CLI:

[mcp_servers]
  [mcp_servers.clix]
  command = "npx"
  args = ["-y", "@clix-so/clix-mcp-server@latest"]

Restart your MCP client to load the configuration.

Command-Line Options

clix-mcp-server [options]

--version, -v  Show version
--help, -h     Show help

Usage

This package runs as an MCP server. Once configured in your MCP client, you can invoke search_docs and search_sdk directly from the client’s tool palette or assistant UI.

Notes:

  • Network access is required to fetch documentation pages and SDK source files.
  • Default timeouts and result counts can be tuned via environment variables:
    • DOCS_SEARCH_MAX_RESULTS (default: 3)
    • SDK_SEARCH_MAX_RESULTS (default: 3)

Local Development

Local Setup

# Clone and install
git clone https://github.com/clix-so/clix-mcp-server.git
cd clix-mcp-server
npm install

# Build
npm run build

# Run tests
npm test

# Development mode (watch for changes)
npm run dev

MCP Client Configuration for Local Development

Before the package is published, configure your MCP client to use the local build:

{
  "mcpServers": {
    "clix": {
      "command": "node",
      "args": ["/absolute/path/to/clix-mcp-server/dist/index.js"]
    }
  }
}

Replace /absolute/path/to/clix-mcp-server with your actual project path.

Contributing

Contributions are welcome! Please read our guidelines in CONTRIBUTING.md and open an issue to discuss significant changes before submitting a PR.

Support

If you encounter issues or have feature requests, please open an issue on GitHub. For usage questions, check the docs and examples returned by the tools.

License

MIT License with Custom Restrictions - see LICENSE for details.

Resources

About

Clix MCP Server enables AI agents to provide real-time, trusted Clix documentation and SDK code examples for seamless integrations.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •