b780e5b807
1. Updates `arcade configure claude --from-local` to create a valid json
config for claude desktop. NOTE: The `arcade configure` command needs
some re-work. It's fragile.
2. Fixes bug where stdio servers were sending logs to the wrong sink.
3. Disabled colorized logs for stdio.
4. Added missing dependency `httpx` for servers created with `arcade
new`
## Claude Desktop json configuration for stdio
Personally I like option 1 because the configuration looks the simplest
### Option 1:
Equivalent to `python server.py stdio`
```
{
"globalShortcut": "Alt+Ctrl+Space",
"mcpServers": {
"my_server": {
"command": "/path/to/my/mcp/server/directory/.venv/bin/python",
"args": [
"/path/to/my/mcp/server/directory/server.py",
"stdio"
]
}
}
}
```
### Option 2:
Equivalent to `uv run server.py stdio`
```
{
"mcpServers": {
"my_server": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/my/mcp/server/directory",
"python",
"server.py",
"stdio"
]
}
}
}
```
### Option 3:
Equivalent to `python -m arcade_mcp_server stdio --cwd ./`
```
{
"mcpServers": {
"my_server": {
"command": "/path/to/my/mcp/server/directory/.venv/bin/python",
"args": [
"-m",
"arcade_mcp_server",
"stdio",
"--cwd",
"/path/to/my/mcp/server/directory"
]
}
}
}
```
|
||
|---|---|---|
| .. | ||
| arcade_mcp_server | ||
| docs | ||
| Makefile | ||
| mkdocs.yml | ||
| pyproject.toml | ||
| README.md | ||
Arcade MCP Server
Arcade MCP (Model Context Protocol) Server enables AI assistants and development tools to interact with your Arcade tools through a standardized protocol. Build, deploy, and integrate MCP servers seamlessly across different AI platforms.
Quick Links
- Quickstart Guide - Get up and running in minutes
- Walkthrough - Learn by example
- API Reference - MCPApp API documentation
Features
- 🚀 FastAPI-like Interface - Simple, intuitive API with
MCPApp - 🔧 Tool Discovery - Automatic discovery of tools in your project
- 🔌 Multiple Transports - Support for stdio and HTTP/SSE
- 🤖 Multi-Client Support - Works with Claude, Cursor, and more
- 📦 Package Integration - Load installed Arcade packages
- 🔐 Built-in Security - Environment-based configuration and secrets
- 🔄 Hot Reload - Development mode with automatic reloading
- 📊 Production Ready - Deploy with Docker, systemd, PM2, or cloud platforms
Getting Started
Installation
pip install arcade-mcp-server
Create Your First Server
from arcade_mcp_server import MCPApp
from typing import Annotated
app = MCPApp(name="my-tools", version="1.0.0")
@app.tool
def greet(name: Annotated[str, "Name to greet"]) -> str:
"""Greet someone by name."""
return f"Hello, {name}!"
if __name__ == "__main__":
app.run()
Run Your Server
# For development
python my_tools.py
# For Claude Desktop
python -m arcade_mcp_server stdio
# For HTTP clients
python -m arcade_mcp_server --host 0.0.0.0 --port 8080
Community
License
Arcade MCP Server is open source software licensed under the MIT license.