mcpx-py
About
Python client library for https://mcp.run - call portable & secure tools for your AI Agents and Apps
Details
- Author
- dylibso
- GitHub stars
- 25
- Downloads
- 412
- Categories
- Other, AI
Jump to
- Python library for LLM interaction via mcp.run tools.
- Supports all models supported by PydanticAI.
- Structured output with Pydantic models.
- Command line interface for chat, list, and tool calls.
- Works with Anthropic, OpenAI, Gemini, Ollama, and Llamafile.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
mcpx-pyCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the library via uv add mcpx-py or pip install mcpx-py. Obtain an mcp.run session ID by running npx --yes -p @dylibso/mcpx gen-session --write and set the MCP_RUN_SESSION_ID environment variable. Then import mcpx_py to use the Chat class or invoke the mcpx-client command-line tool.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcpx-py": {
"mcpx-py": {
"command": "npx",
"args": [
"--yes",
"-p",
"@dylibso/mcpx",
"gen-session",
"--write"
]
}
}
}
}McpServers
{
"mcpx-py": {
"command": "npx",
"args": [
"--yes",
"-p",
"@dylibso/mcpx",
"gen-session",
"--write"
]
}
}mcpx-py
A Python library for interacting with LLMs using mcp.run tools
Features
AI Provider Support
mcpx-py supports all models supported by PydanticAI
Dependencies
- uv
- npm
- ollama (optional)
mcp.run Setup
You will need to get an mcp.run session ID by running:
npx --yes -p @dylibso/mcpx gen-session --write
This will generate a new session and write the session ID to a configuration file that can be used
by mcpx-py.
If you need to store the session ID in an environment variable you can run gen-session
without the --write flag:
npx --yes -p @dylibso/mcpx gen-session
which should output something like:
Login successful!
Session: kabA7w6qH58H7kKOQ5su4v3bX_CeFn4k.Y4l/s/9dQwkjv9r8t/xZFjsn2fkLzf+tkve89P1vKhQ
Then set the MPC_RUN_SESSION_ID environment variable:
$ export MCP_RUN_SESSION_ID=kabA7w6qH58H7kKOQ5su4v3bX_CeFn4k.Y4l/s/9dQwkjv9r8t/xZFjsn2fkLzf+tkve89P1vKhQ
Python Usage
Installation
Using uv:
uv add mcpx-py
Or pip:
pip install mcpx-py
Example code
```python
from mcpx_py import Chat
llm = Chat("claude-3-5-sonnet-latest")
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
