Metadata-Version: 2.4
Name: kimcp
Version: 0.1.0
Summary: A CLI and API gateway for managing MCP server connections
Project-URL: homepage, https://github.com/kiarina/kimcp
Project-URL: repository, https://github.com/kiarina/kimcp
Project-URL: documentation, https://github.com/kiarina/kimcp
Author-email: kiarina <kiarinadawa@gmail.com>
License: MIT
License-File: LICENSE
Keywords: cli,gateway,mcp,model-context-protocol
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: fastapi>=0.115.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: langchain-core>=0.3.0
Requires-Dist: langchain-mcp-adapters>=0.1.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: platformdirs>=4.0.0
Requires-Dist: psutil>=6.0.0
Requires-Dist: pydantic-settings-manager>=3.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: rich-click>=1.8.0
Requires-Dist: uvicorn>=0.30.0
Description-Content-Type: text/markdown

# kimcp

`kimcp` is a small MCP gateway for registering MCP servers, listing tools, running tools, and disconnecting servers through a CLI backed by a local FastAPI gateway.

## Installation

```sh
pip install kimcp
```

## Usage

Start the gateway:

```sh
kimcp serve
```

Connect a stdio MCP server:

```sh
kimcp connect stdio --server-name math --command python --arg ./server.py
```

List registered MCP servers:

```sh
kimcp list-mcp-servers
```

List tools for a server:

```sh
kimcp list-tools --server-name math
```

Run a tool:

```sh
kimcp run-tool --server-name math --tool-name add --tool-args '{"a": 1, "b": 2}'
```

Disconnect a server:

```sh
kimcp disconnect --server-name math
```

Stop the gateway:

```sh
kimcp shutdown
```

## Development

```sh
mise run setup
mise run ci
```
