home / mcp / native mcp server

Native MCP Server

Provides a local MCP server that exposes tools for React Native development via the Model Context Protocol.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "arkvex-native_mcp": {
      "command": "uv",
      "args": [
        "run",
        "mcp_server.py"
      ]
    }
  }
}

Native MCP is an extensible MCP server that provides tools for React Native development. It enables AI assistants and development tooling to generate components and perform common tasks through the Model Context Protocol, delivering a consistent integration layer between editors, assistants, and your local project.

How to use

You interact with the Native MCP server through an MCP client or your editor’s integrated extension. Start by initializing the connection, then request the list of available tools, and finally call a tool to perform a task. The server exposes a set of tools designed to help you generate React Native components and run other development utilities. You can generate a component by invoking the generate_component tool and supplying the required input, such as the component_name. Use the tools to accelerate development, iterate on components quickly, and keep project structure consistent.

How to install

Prerequisites you need before installing: Python 3.12 or higher and the uv package manager. You may also use a code editor with MCP integration for a smoother workflow.

git clone https://github.com/ArkVex/Native_MCP.git
cd Native_MCP
uv sync
uv run mcp_server.py

Additional setup and usage notes

The server loads tools from the tools/ directory at startup. You can add custom tools by creating a new tool directory under tools/, implementing your logic, and providing a tool manifest (mcp.json) that describes the commands and parameters. Restart the server after adding or updating tools so the server picks up changes.

To use the built-in React Native tool, you can generate a basic component by providing a component_name. The tool outputs a complete React Native functional component with View and Text elements suitable for immediate use in your project.

Troubleshooting and notes

If the server won’t start, confirm Python 3.12+ and uv are installed and in your PATH. Run uv sync to install dependencies, then start the server with uv run mcp_server.py. If tools fail to load, verify the tools/ directory structure and that each tool has a valid mcp.json manifest. Check that the server process is running and review console logs for detailed error messages.

Available tools

generate_component

Generates a basic React Native functional component with a View and Text elements based on the given component_name.