https://github.com/professionalwiki/mediawiki-mcp-server
Model Context Protocol (MCP) Server that interacts with any MediaWiki wiki
https://github.com/professionalwiki/mediawiki-mcp-server
mcp-server mediawiki model-context-protocol-servers
Last synced: 5 months ago
JSON representation
Model Context Protocol (MCP) Server that interacts with any MediaWiki wiki
- Host: GitHub
- URL: https://github.com/professionalwiki/mediawiki-mcp-server
- Owner: ProfessionalWiki
- License: gpl-2.0
- Created: 2025-05-12T17:55:22.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-20T22:52:42.000Z (12 months ago)
- Last Synced: 2025-06-20T23:30:48.962Z (12 months ago)
- Topics: mcp-server, mediawiki, model-context-protocol-servers
- Language: TypeScript
- Homepage: https://professional.wiki/en/mediawiki-mcp-server
- Size: 144 KB
- Stars: 4
- Watchers: 4
- Forks: 3
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- toolsdk-mcp-registry - ✅ @professional-wiki/mediawiki-mcp-server
README
# MediaWiki MCP Server
[](https://www.npmjs.com/package/@professional-wiki/mediawiki-mcp-server) [](https://smithery.ai/server/@ProfessionalWiki/mediawiki-mcp-server) [](./LICENSE)
An MCP (Model Context Protocol) server that enables Large Language Model (LLM) clients to interact with any MediaWiki wiki.
## Feature
### Tools
| Name | Description | Permissions |
|---|---|---|
| `add-wiki` | Adds a new wiki as an MCP resource from a URL. | - |
| `create-page` 🔐 | Create a new wiki page. | `Create, edit, and move pages` |
| `delete-page` 🔐 | Delete a wiki page. | `Delete pages, revisions, and log entries` |
| `get-category-members` | Gets all members in the category | - |
| `get-file` | Returns the standard file object for a file page. | - |
| `get-page` | Returns the standard page object for a wiki page. | - |
| `get-page-history` | Returns information about the latest revisions to a wiki page. | - |
| `get-revision` | Returns the standard revision object for a page. | - |
| `remove-wiki` | Removes a wiki resource. | - |
| `search-page` | Search wiki page titles and contents for the provided search terms. | - |
| `search-page-by-prefix` | Perform a prefix search for page titles. | - |
| `set-wiki` | Sets the wiki resource to use for the current session. | - |
| `undelete-page` 🔐 | Undelete a wiki page. | `Delete pages, revisions, and log entries` |
| `update-page` 🔐 | Update an existing wiki page. | `Edit existing pages` |
| `upload-file` 🔐 | Uploads a file to the wiki from the local disk. | `Upload new files` |
| `upload-file-from-url` 🔐 | Uploads a file to the wiki from a web URL. | `Upload, replace, and move files` |
### Resources
`mcp://wikis/{wikiKey}`
- Credentials (e.g., `token`, `username`, `password`) are never exposed in resource content.
- After `add-wiki`/`remove-wiki`, the server sends `notifications/resources/list_changed` so clients refresh.
Example list result
```json
{
"resources": [
{
"uri": "mcp://wikis/en.wikipedia.org",
"name": "wikis/en.wikipedia.org",
"title": "Wikipedia",
"description": "Wiki \"Wikipedia\" hosted at https://en.wikipedia.org"
}
]
}
```
Example read result
```json
{
"contents": [
{
"uri": "mcp://wikis/en.wikipedia.org",
"mimeType": "application/json",
"text": "{ \"sitename\":\"Wikipedia\",\"server\":\"https://en.wikipedia.org\",\"articlepath\":\"/wiki\",\"scriptpath\":\"/w\",\"private\":false }"
}
]
}
```
### Environment variables
| Name | Description | Default |
|---|---|---|
| `CONFIG` | Path to your configuration file | `config.json` |
| `MCP_TRANSPORT` | Type of MCP server transport (`stdio` or `http`) | `stdio` |
| `PORT` | Port used for StreamableHTTP transport | `3000` |
## Configuration
> **Note:** Config is only required when interacting with a private wiki or using authenticated tools.
Create a `config.json` file to configure wiki connections. Use the `config.example.json` as a starting point.
### Basic structure
```json
{
"defaultWiki": "en.wikipedia.org",
"wikis": {
"en.wikipedia.org": {
"sitename": "Wikipedia",
"server": "https://en.wikipedia.org",
"articlepath": "/wiki",
"scriptpath": "/w",
"token": null,
"username": null,
"password": null,
"private": false
}
}
}
```
### Configuration fields
| Field | Description |
|---|---|
| `defaultWiki` | The default wiki identifier to use (matches a key in `wikis`) |
| `wikis` | Object containing wiki configurations, keyed by domain/identifier |
### Wiki configuration fields
| Field | Required | Description |
|---|---|---|
| `sitename` | Yes | Display name for the wiki |
| `server` | Yes | Base URL of the wiki (e.g., `https://en.wikipedia.org`) |
| `articlepath` | Yes | Path pattern for articles (typically `/wiki`) |
| `scriptpath` | Yes | Path to MediaWiki scripts (typically `/w`) |
| `token` | No | OAuth2 access token for authenticated operations (preferred) |
| `username` | No | Bot username (fallback when OAuth2 is not available) |
| `password` | No | Bot password (fallback when OAuth2 is not available) |
| `private` | No | Whether the wiki requires authentication to read (default: `false`) |
### Authentication setup
For tools marked with 🔐, authentication is required.
**Preferred method: OAuth2 Token**
1. Navigate to `Special:OAuthConsumerRegistration/propose/oauth2` on your wiki
2. Select "This consumer is for use only by [YourUsername]"
3. Grant the necessary permissions
4. After approval, you'll receive:
- Client ID
- Client Secret
- Access Token
5. Add the `token` to your wiki configuration in `config.json`
> **Note:** OAuth2 requires the [OAuth extension](https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:OAuth) to be installed on the wiki.
**Fallback method: Username & Password**
If OAuth2 is not available on your wiki, you can use bot credentials (from `Special:BotPasswords` ) instead of the OAuth2 token.
## Installation
Install via Smithery
To install MediaWiki MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ProfessionalWiki/mediawiki-mcp-server):
```bash
npx -y @smithery/cli install @ProfessionalWiki/mediawiki-mcp-server --client claude
```
Install in Claude Desktop
Follow the [guide](https://modelcontextprotocol.io/quickstart/user), use following configuration:
```json
{
"mcpServers": {
"mediawiki-mcp-server": {
"command": "npx",
"args": [
"@professional-wiki/mediawiki-mcp-server@latest"
],
"env": {
"CONFIG": "path/to/config.json"
}
}
}
}
```
Install in VS Code
[](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522mediawiki-mcp-server%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540professional-wiki%252Fmediawiki-mcp-server%2540latest%2522%255D%257D)
[](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522mediawiki-mcp-server%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540professional-wiki%252Fmediawiki-mcp-server%2540latest%2522%255D%257D)
```bash
code --add-mcp '{"name":"mediawiki-mcp-server","command":"npx","args":["@professional-wiki/mediawiki-mcp-server@latest"]}'
```
Install in Cursor
[](https://cursor.com/install-mcp?name=mediawiki-mcp-server&config=eyJjb21tYW5kIjoibnB4IEBwcm9mZXNzaW9uYWwtd2lraS9tZWRpYXdpa2ktbWNwLXNlcnZlckBsYXRlc3QifQ%3D%3D)
Go to `Cursor Settings` -> `MCP` -> `Add new MCP Server`. Name to your liking, use `command` type with the command `npx @professional-wiki/mediawiki-mcp-server`. You can also verify config or add command like arguments via clicking `Edit`.
```json
{
"mcpServers": {
"mediawiki-mcp-server": {
"command": "npx",
"args": [
"@professional-wiki/mediawiki-mcp-server@latest"
],
"env": {
"CONFIG": "path/to/config.json"
}
}
}
}
```
Install in Windsurf
Follow the [guide](https://docs.windsurf.com/windsurf/cascade/mcp), use following configuration:
```json
{
"mcpServers": {
"mediawiki-mcp-server": {
"command": "npx",
"args": [
"@professional-wiki/mediawiki-mcp-server@latest"
],
"env": {
"CONFIG": "path/to/config.json"
}
}
}
}
```
Install in Claude Code
Follow the [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp).
Run the below command, optionally with `-e` flags to specify environment variables.
claude mcp add mediawiki-mcp-server npx @professional-wiki/mediawiki-mcp-server@latest
You should end up with something like the below in your `.claude.json` config:
```json
"mcpServers": {
"mediawiki-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"@professional-wiki/mediawiki-mcp-server@latest"
],
"env": {
"CONFIG": "path/to/config.json"
}
}
},
```
## Development
> 🐋 **Develop with Docker:** Replace the `npm run` part of the command with `make` (e.g. `make inspector`).
### [MCP Inspector](https://github.com/modelcontextprotocol/inspector)
Test and debug the MCP server without a MCP client and LLM.
To start the development server and the MCP Inspector together:
```sh
npm run inspector
```
The command will build and start the MCP Proxy server locally at `6277` and the MCP Inspector client UI at `http://localhost:6274`.
### [MCPJam Inspector](https://github.com/MCPJam/inspector)
Test and debug the MCP server, with a built-in MCP client and support for different LLMs.
To start the development server and the MCP Inspector together:
```sh
npm run mcpjam
```
### Test with MCP clients
To enable your MCP client to use this MediaWiki MCP Server for local development:
1. [Install](#installation) the MCP server on your MCP client.
2. Change the `command` and `args` values as shown in the [`mcp.json`](mcp.json) file (or [`mcp.docker.json`](mcp.docker.json) if you prefer to run the MCP server in Docker).
3. Run the `dev` command so that the source will be compiled whenever there is a change:
```sh
npm run dev
```
### Release process
To release a new version:
1. Use npm version to create a release
```sh
# For patch release (0.1.1 → 0.1.2)
npm version patch
# For minor release (0.1.1 → 0.2.0)
npm version minor
# For major release (0.1.1 → 1.0.0)
npm version major
# Or specify exact version
npm version 0.2.0
```
This command automatically:
- Updates `package.json` and `package-lock.json`
- Syncs the version in `server.json`, `mcpb/manifest.json`, `Dockerfile` (via the version script)
- Creates a git commit
- Creates a git tag (e.g., `v0.2.0`)
2. Push to GitHub
```sh
git push origin master --follow-tags
```
The `release` GitHub workflow will trigger automatically:
- Build a MCP bundle `.mcpb` and publish to [GitHub](https://github.com/ProfessionalWiki/MediaWiki-MCP-Server/releases)
- Build and publish to [NPM](https://www.npmjs.com/package/@professional-wiki/mediawiki-mcp-server)
- Publish to the [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.professionalwiki/mediawiki-mcp-server)
## Contributing
Contributions are welcome! Please feel free to submit a pull request or open an issue for bugs, feature requests, or suggestions.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.