README.md•4.11 kB
# Consumer Rights Wiki MCP Server
A Model Context Protocol (MCP) server that provides access to the Consumer Rights Wiki, a platform documenting modern consumer exploitation issues.
## Overview
This MCP server enables AI assistants to interact with the Consumer Rights Wiki (https://consumerrights.wiki), which documents various forms of consumer exploitation including:
- Privacy violations and data misuse
- Dark patterns in user interfaces
- Forced arbitration clauses
- Ownership rights violations
- Deceptive pricing practices
- And more modern consumer issues
## Features
The server provides the following tools:
### 1. `search_wiki`
Search for articles in the Consumer Rights Wiki.
- **Parameters:**
- `query` (required): Search terms
- `limit` (optional): Number of results (default: 10, max: 50)
### 2. `get_page_content`
Retrieve the full content of a specific wiki page.
- **Parameters:**
- `title` (required): The page title
- `section` (optional): Specific section number to retrieve
### 3. `get_page_info`
Get metadata about a wiki page including revision history, categories, and protection status.
- **Parameters:**
- `title` (required): The page title
### 4. `get_recent_changes`
View recent changes to the wiki.
- **Parameters:**
- `limit` (optional): Number of changes to return (default: 10, max: 50)
- `namespace` (optional): Filter by namespace (0 = main articles)
### 5. `get_categories`
List all categories or pages within a specific category.
- **Parameters:**
- `category` (optional): Category name (without "Category:" prefix)
- `limit` (optional): Number of results (default: 20, max: 50)
### 6. `get_page_sections`
Get the section structure of a wiki page.
- **Parameters:**
- `title` (required): The page title
## Installation
1. Clone this repository or create a new directory:
```bash
mkdir consumer-rights-wiki-mcp
cd consumer-rights-wiki-mcp
```
2. Save the provided files:
- `src/index.ts` (the main server code)
- `package.json`
- `tsconfig.json`
3. Install dependencies:
```bash
npm install
```
4. Build the TypeScript code:
```bash
npm run build
```
## Configuration
### For Claude Desktop
Add the following to your Claude Desktop configuration file:
**On macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**On Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"consumer-rights-wiki": {
"command": "node",
"args": ["path/to/consumer-rights-wiki-mcp/build/index.js"]
}
}
}
```
### For Other MCP Clients
The server runs on stdio transport. Start it with:
```bash
npm start
```
## Usage Examples
Once configured, you can ask your AI assistant to:
1. **Search for companies:**
"Search the Consumer Rights Wiki for information about X Corp"
2. **Get detailed article content:**
"Get the full content of the X Corp article from Consumer Rights Wiki"
3. **Browse recent changes:**
"Show me the most recent changes to Consumer Rights Wiki"
4. **Explore categories:**
"What categories are available in Consumer Rights Wiki?"
"Show me all articles in the 'Privacy violations' category"
5. **Get page structure:**
"What sections are in the 'Apple Inc.' article?"
## Development
For development with hot reloading:
```bash
npm run dev
```
To clean build artifacts:
```bash
npm run clean
```
## API Limitations
- The server uses the public MediaWiki API, which has rate limits
- Search results are limited to 50 per query
- Some content may require authentication for editing (not implemented in this version)
## Contributing
This MCP server is designed to help expose consumer exploitation practices. Consider contributing to:
- The Consumer Rights Wiki itself by documenting consumer issues
- This MCP server by adding new features or improving existing ones
## License
MIT License
## Related Resources
- [Consumer Rights Wiki](https://consumerrights.wiki)
- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
- [MediaWiki API Documentation](https://www.mediawiki.org/wiki/API:Main_page)