59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
# Cities MCP: a simple MCP server for managing Web pages in your Neocities sites
|
|
|
|
This is an stdio-only, Python-based MCP server that allows your coding agent to manage your Neocities web pages: list, sync, upload and do everything else that an official free-tier Neocities API allows. Additionally, it supports managing multiple accounts at once, thanks to the config format invented for the [Multicities](https://codeberg.org/luxferre/sh-goodies/src/branch/master/cities.sh) site manager.
|
|
|
|
**Disclaimer**: this, as well as Multicities, is a purely hobbyist project that is not affiliated with Neocities hosting in any possible way. It makes use of the official Neocities API that may at any moment become outdated or subject to additional restrictions without prior notice or updates to this package. Use at your own risk and discretion.
|
|
|
|
## Installation
|
|
|
|
You'll need `uv` as a prerequisite, although you can build the package using different methods.
|
|
|
|
First, clone the repo and run `uv build`:
|
|
|
|
```
|
|
git clone https://codeberg.org/luxferre/cities-mcp.git
|
|
cd cities-mcp
|
|
uv build
|
|
```
|
|
|
|
Then, configure your coding agent.
|
|
|
|
For Gemini CLI/Antigravity/Cursor/Claude etc, the configuration should look like this:
|
|
|
|
```
|
|
"mcpServers": {
|
|
//...
|
|
"neocities": {
|
|
"command": "uv",
|
|
"args": [
|
|
"run",
|
|
"--directory",
|
|
"/path/to/your/cities-mcp",
|
|
"cities-mcp"
|
|
]
|
|
},
|
|
//...
|
|
}
|
|
```
|
|
|
|
For OpenCode, it should look like this:
|
|
```
|
|
"mcp": {
|
|
//...
|
|
"neocities": {
|
|
"type": "local",
|
|
"enabled": true,
|
|
"command": ["uv", "run", "--directory", "/path/to/your/cities-mcp", "cities-mcp"]
|
|
},
|
|
//...
|
|
}
|
|
```
|
|
|
|
## Account configuration
|
|
|
|
The Neocities account config file format is fully compatible with the one used in Multicities. Just log in with either Multicities or directly via your coding agent using this server's `login` tool, and you're ready to go.
|
|
|
|
## Credits
|
|
|
|
Created by Luxferre in 2026, released into public domain with no warranties.
|