{"_id":"@iflow-mcp/mediawiki-mcp-server","name":"@iflow-mcp/mediawiki-mcp-server","dist-tags":{"latest":"0.6.6"},"versions":{"0.6.6":{"name":"@iflow-mcp/mediawiki-mcp-server","version":"0.6.6","description":"Model Context Protocol (MCP) server for MediaWiki","mcpName":"io.github.ProfessionalWiki/mediawiki-mcp-server","keywords":["modelcontextprotocol","mcp","mediawiki","wiki","wikipedia","wikimedia","knowledge","wikibase","smw"],"homepage":"https://github.com/ProfessionalWiki/MediaWiki-MCP-Server","bugs":{"url":"https://github.com/ProfessionalWiki/MediaWiki-MCP-Server/issues"},"license":"MIT","author":{"name":"Professional Wiki","url":"https://professional.wiki"},"type":"module","main":"dist/index.js","bin":{"iflow-mcp_mediawiki-mcp-server":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/ProfessionalWiki/MediaWiki-MCP-Server.git"},"engines":{"node":">=18"},"scripts":{"start":"node dist/index.js","start:http":"MCP_TRANSPORT=http node dist/index.js","dev":"tsc --watch","build":"tsc","test":"echo \"Error: no test specified\" && exit 1","lint":"eslint --cache src/**/*","validate:server-json":"node scripts/validate-server-json.cjs","preflight":"npm ci && npm run lint && npm run validate:server-json && npm run build && npm run bundle -- --clean","inspector":"concurrently --kill-others \"tsc --watch\" \"npx -y @modelcontextprotocol/inspector@latest node dist/index.js\"","inspector:http":"concurrently --kill-others \"tsc --watch\" \"npx -y @modelcontextprotocol/inspector@latest\" \"MCP_TRANSPORT=http node dist/index.js\"","mcpjam":"concurrently --kill-others \"tsc --watch\" \"npx -y @mcpjam/inspector@latest node $(pwd)/dist/index.js\"","bundle":"npm run build && node scripts/bundle.cjs","preversion":"npm run preflight","version":"node scripts/sync-version.cjs && git add server.json mcpb/manifest.json Dockerfile"},"dependencies":{"@modelcontextprotocol/sdk":"^1.25.2","express":"^5.1.0","mwn":"^3.0.1","node-fetch":"^3.3.2","types-mediawiki-api":"^2.0.0"},"devDependencies":{"@anthropic-ai/mcpb":"^2.1.2","@types/express":"^5.0.2","@types/node":"^25.0.2","@types/node-fetch":"^2.6.12","@typescript-eslint/eslint-plugin":"^8.19.0","@typescript-eslint/parser":"^8.19.0","ajv":"^8.17.1","ajv-formats":"^3.0.1","concurrently":"^9.1.2","eslint":"^8.57.0","eslint-config-wikimedia":"^0.32.2","typescript":"^5.8.3"},"_id":"@iflow-mcp/mediawiki-mcp-server@0.6.6","_integrity":"sha512-FarvvI+NvIC1djb4BH8E8MSeq/qvbbxsIvibpjwzAniNYAe1NQrG0VOUUOlOc19rWT3FMK9Tt18OKjtpiyg7Hg==","_resolved":"/app/auto-mcp-upload/data/16839/iflow-mcp-mediawiki-mcp-server-0.6.6.tgz","_from":"file:/app/auto-mcp-upload/data/16839/iflow-mcp-mediawiki-mcp-server-0.6.6.tgz","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-FarvvI+NvIC1djb4BH8E8MSeq/qvbbxsIvibpjwzAniNYAe1NQrG0VOUUOlOc19rWT3FMK9Tt18OKjtpiyg7Hg==","shasum":"b1fcbf577e17d59fdde4b5d0e082fcb8cdbe4425","tarball":"https://registry.npmjs.org/@iflow-mcp/mediawiki-mcp-server/-/mediawiki-mcp-server-0.6.6.tgz","fileCount":35,"unpackedSize":67948,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIB1XvLfmN6qFxYTGVDjy9cdZLowK7WCmvS2RJY2PzmrZAiEAkz6QE2kToFWzY86STd8VdXXVt98JMQSXaNL3t9jmOKU="}]},"_npmUser":{"name":"chatflowdev","email":"chatflowdev@gmail.com"},"directories":{},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mediawiki-mcp-server_0.6.6_1772712125871_0.4302823876347852"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-05T12:02:05.756Z","0.6.6":"2026-03-05T12:02:06.010Z","modified":"2026-03-05T12:02:06.301Z"},"maintainers":[{"name":"chatflowdev","email":"chatflowdev@gmail.com"},{"name":"qystart","email":"987472953@qq.com"}],"description":"Model Context Protocol (MCP) server for MediaWiki","homepage":"https://github.com/ProfessionalWiki/MediaWiki-MCP-Server","keywords":["modelcontextprotocol","mcp","mediawiki","wiki","wikipedia","wikimedia","knowledge","wikibase","smw"],"repository":{"type":"git","url":"git+https://github.com/ProfessionalWiki/MediaWiki-MCP-Server.git"},"author":{"name":"Professional Wiki","url":"https://professional.wiki"},"bugs":{"url":"https://github.com/ProfessionalWiki/MediaWiki-MCP-Server/issues"},"license":"MIT","readme":"# MediaWiki MCP Server\n[![NPM Version](https://img.shields.io/npm/v/%40professional-wiki%2Fmediawiki-mcp-server?color=red)](https://www.npmjs.com/package/@professional-wiki/mediawiki-mcp-server) [![smithery badge](https://smithery.ai/badge/@ProfessionalWiki/mediawiki-mcp-server)](https://smithery.ai/server/@ProfessionalWiki/mediawiki-mcp-server) [![MIT licensed](https://img.shields.io/npm/l/%40professional-wiki%2Fmediawiki-mcp-server)](./LICENSE)\n\nAn MCP (Model Context Protocol) server that enables Large Language Model (LLM) clients to interact with any MediaWiki wiki.\n\n## Feature\n\n### Tools\n\n| Name | Description | Permissions |\n|---|---|---|\n| `add-wiki` | Adds a new wiki as an MCP resource from a URL. | - |\n| `create-page` 🔐 | Create a new wiki page. | `Create, edit, and move pages` |\n| `delete-page` 🔐 | Delete a wiki page. | `Delete pages, revisions, and log entries` |\n| `get-category-members` | Gets all members in the category | - |\n| `get-file` | Returns the standard file object for a file page. | - |\n| `get-page` | Returns the standard page object for a wiki page. | - |\n| `get-page-history` | Returns information about the latest revisions to a wiki page. | - |\n| `get-revision` | Returns the standard revision object for a page. | - |\n| `remove-wiki` | Removes a wiki resource. | - |\n| `search-page` | Search wiki page titles and contents for the provided search terms. | - |\n| `search-page-by-prefix` | Perform a prefix search for page titles. | - |\n| `set-wiki` | Sets the wiki resource to use for the current session. | - |\n| `undelete-page` 🔐 | Undelete a wiki page. | `Delete pages, revisions, and log entries` |\n| `update-page` 🔐 | Update an existing wiki page. | `Edit existing pages` |\n| `upload-file` 🔐 | Uploads a file to the wiki from the local disk. | `Upload new files` |\n| `upload-file-from-url` 🔐 | Uploads a file to the wiki from a web URL. | `Upload, replace, and move files` |\n\n### Resources\n\n`mcp://wikis/{wikiKey}`\n- Credentials (e.g., `token`, `username`, `password`) are never exposed in resource content.\n- After `add-wiki`/`remove-wiki`, the server sends `notifications/resources/list_changed` so clients refresh.\n\n<details><summary>Example list result</summary>\n\n```json\n{\n  \"resources\": [\n    {\n      \"uri\": \"mcp://wikis/en.wikipedia.org\",\n      \"name\": \"wikis/en.wikipedia.org\",\n      \"title\": \"Wikipedia\",\n      \"description\": \"Wiki \\\"Wikipedia\\\" hosted at https://en.wikipedia.org\"\n    }\n  ]\n}\n```\n</details>\n\n<details><summary>Example read result</summary>\n\n```json\n{\n  \"contents\": [\n    {\n      \"uri\": \"mcp://wikis/en.wikipedia.org\",\n      \"mimeType\": \"application/json\",\n      \"text\": \"{ \\\"sitename\\\":\\\"Wikipedia\\\",\\\"server\\\":\\\"https://en.wikipedia.org\\\",\\\"articlepath\\\":\\\"/wiki\\\",\\\"scriptpath\\\":\\\"/w\\\",\\\"private\\\":false }\"\n    }\n  ]\n}\n```\n</details>\n\n### Environment variables\n| Name | Description | Default |\n|---|---|---|\n| `CONFIG` | Path to your configuration file | `config.json` |\n| `MCP_TRANSPORT` | Type of MCP server transport (`stdio` or `http`) | `stdio` |\n| `PORT` | Port used for StreamableHTTP transport | `3000` |\n\n## Configuration\n\n> **Note:** Config is only required when interacting with a private wiki or using authenticated tools.\n\nCreate a `config.json` file to configure wiki connections. Use the `config.example.json` as a starting point.\n\n### Basic structure\n\n```json\n{\n  \"defaultWiki\": \"en.wikipedia.org\",\n  \"wikis\": {\n    \"en.wikipedia.org\": {\n      \"sitename\": \"Wikipedia\",\n      \"server\": \"https://en.wikipedia.org\",\n      \"articlepath\": \"/wiki\",\n      \"scriptpath\": \"/w\",\n      \"token\": null,\n      \"username\": null,\n      \"password\": null,\n      \"private\": false\n    }\n  }\n}\n```\n\n### Configuration fields\n\n| Field | Description |\n|---|---|\n| `defaultWiki` | The default wiki identifier to use (matches a key in `wikis`) |\n| `wikis` | Object containing wiki configurations, keyed by domain/identifier |\n\n### Wiki configuration fields\n\n| Field | Required | Description |\n|---|---|---|\n| `sitename` | Yes | Display name for the wiki |\n| `server` | Yes | Base URL of the wiki (e.g., `https://en.wikipedia.org`) |\n| `articlepath` | Yes | Path pattern for articles (typically `/wiki`) |\n| `scriptpath` | Yes | Path to MediaWiki scripts (typically `/w`) |\n| `token` | No | OAuth2 access token for authenticated operations (preferred) |\n| `username` | No | Bot username (fallback when OAuth2 is not available) |\n| `password` | No | Bot password (fallback when OAuth2 is not available) |\n| `private` | No | Whether the wiki requires authentication to read (default: `false`) |\n\n### Authentication setup\n\nFor tools marked with 🔐, authentication is required.\n\n**Preferred method: OAuth2 Token**\n\n1. Navigate to `Special:OAuthConsumerRegistration/propose/oauth2` on your wiki\n2. Select \"This consumer is for use only by [YourUsername]\"\n3. Grant the necessary permissions\n4. After approval, you'll receive:\n   - Client ID\n   - Client Secret\n   - Access Token\n5. Add the `token` to your wiki configuration in `config.json`\n\n> **Note:** OAuth2 requires the [OAuth extension](https://www.mediawiki.org/wiki/Special:MyLanguage/Extension:OAuth) to be installed on the wiki.\n\n**Fallback method: Username & Password**\n\nIf OAuth2 is not available on your wiki, you can use bot credentials (from `Special:BotPasswords` ) instead of the OAuth2 token.\n\n## Installation\n\n<details><summary><b>Install via Smithery</b></summary>\n\nTo install MediaWiki MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ProfessionalWiki/mediawiki-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @ProfessionalWiki/mediawiki-mcp-server --client claude\n```\n</details>\n\n<details>\n<summary><b>Install in Claude Desktop</b></summary>\n\nFollow the [guide](https://modelcontextprotocol.io/quickstart/user), use following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"mediawiki-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@professional-wiki/mediawiki-mcp-server@latest\"\n      ],\n      \"env\": {\n        \"CONFIG\": \"path/to/config.json\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details><summary><b>Install in VS Code</b></summary>\n\n[![Install in VS Code](https://img.shields.io/badge/Add%20to-VS%20Code-blue?style=for-the-badge&labelColor=%230e1116&color=%234076b5)](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)\n[![Install in VS Code Insiders](https://img.shields.io/badge/Add%20to-VS%20Code%20Insiders-blue?style=for-the-badge&labelColor=%230e1116&color=%234f967e)](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)\n\n```bash\ncode --add-mcp '{\"name\":\"mediawiki-mcp-server\",\"command\":\"npx\",\"args\":[\"@professional-wiki/mediawiki-mcp-server@latest\"]}'\n```\n</details>\n\n<details>\n<summary><b>Install in Cursor</b></summary>\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=mediawiki-mcp-server&config=eyJjb21tYW5kIjoibnB4IEBwcm9mZXNzaW9uYWwtd2lraS9tZWRpYXdpa2ktbWNwLXNlcnZlckBsYXRlc3QifQ%3D%3D)\n\nGo 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`.\n\n```json\n{\n  \"mcpServers\": {\n    \"mediawiki-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@professional-wiki/mediawiki-mcp-server@latest\"\n      ],\n      \"env\": {\n        \"CONFIG\": \"path/to/config.json\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Install in Windsurf</b></summary>\n\nFollow the [guide](https://docs.windsurf.com/windsurf/cascade/mcp), use following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"mediawiki-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"@professional-wiki/mediawiki-mcp-server@latest\"\n      ],\n      \"env\": {\n        \"CONFIG\": \"path/to/config.json\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Install in Claude Code</b></summary>\n\nFollow the [Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp).\n\nRun the below command, optionally with `-e` flags to specify environment variables.\n\n    claude mcp add mediawiki-mcp-server npx @professional-wiki/mediawiki-mcp-server@latest\n\nYou should end up with something like the below in your `.claude.json` config:\n\n```json\n\"mcpServers\": {\n  \"mediawiki-mcp-server\": {\n    \"type\": \"stdio\",\n    \"command\": \"npx\",\n    \"args\": [\n      \"@professional-wiki/mediawiki-mcp-server@latest\"\n    ],\n    \"env\": {\n      \"CONFIG\": \"path/to/config.json\"\n    }\n  }\n},\n```\n</details>\n\n## Development\n\n> 🐋 **Develop with Docker:** Replace the `npm run` part of the command with `make` (e.g. `make inspector`).\n\n\n### [MCP Inspector](https://github.com/modelcontextprotocol/inspector)\n\nTest and debug the MCP server without a MCP client and LLM.\n\nTo start the development server and the MCP Inspector together:\n```sh\nnpm run inspector\n```\n\nThe command will build and start the MCP Proxy server locally at `6277` and the MCP Inspector client UI at `http://localhost:6274`.\n\n\n### [MCPJam Inspector](https://github.com/MCPJam/inspector)\n\nTest and debug the MCP server, with a built-in MCP client and support for different LLMs.\n\nTo start the development server and the MCP Inspector together:\n```sh\nnpm run mcpjam\n```\n\n### Test with MCP clients\n\nTo enable your MCP client to use this MediaWiki MCP Server for local development: \n\n1. [Install](#installation) the MCP server on your MCP client.\n2. 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).\n3. Run the `dev` command so that the source will be compiled whenever there is a change:\n\n\t```sh\n\tnpm run dev\n\t```\n\n### Release process\n\nTo release a new version:\n\n<details>\n<summary><b>1. Use npm version to create a release</b></summary>\n\n```sh\n# For patch release (0.1.1 → 0.1.2)\nnpm version patch\n\n# For minor release (0.1.1 → 0.2.0)\nnpm version minor\n\n# For major release (0.1.1 → 1.0.0)\nnpm version major\n\n# Or specify exact version\nnpm version 0.2.0\n```\n\nThis command automatically:\n- Updates `package.json` and `package-lock.json`\n- Syncs the version in `server.json`, `mcpb/manifest.json`, `Dockerfile` (via the version script)\n- Creates a git commit\n- Creates a git tag (e.g., `v0.2.0`)\n</details>\n\n<details>\n<summary><b>2. Push to GitHub</b></summary>\n\n```sh\ngit push origin master --follow-tags\n```\n\nThe `release` GitHub workflow will trigger automatically:\n- Build a MCP bundle `.mcpb` and publish to [GitHub](https://github.com/ProfessionalWiki/MediaWiki-MCP-Server/releases)\n- Build and publish to [NPM](https://www.npmjs.com/package/@professional-wiki/mediawiki-mcp-server) \n- Publish to the [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.professionalwiki/mediawiki-mcp-server)\n</details>\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a pull request or open an issue for bugs, feature requests, or suggestions.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","readmeFilename":"README.md","_rev":"1-79837c47028caefd21ff79af4bfe0803"}