Ferengi Rules of Acquisition MCP Server

An MCP server serving the Ferengi Rules of Acquisition as a resource with powerful search and retrieval tools.

Features

• Resource: Access the complete collection of Ferengi Rules of Acquisition
• Tools:
  • `get-rule`: Retrieve a specific rule by number
  • `search-by-theme`: Search rules by theme (profit, business, money, etc.)
  • `random-rule`: Get a random rule from the collection
  • `list-themes`: See all available themes

Setup

1. Install dependencies:

npm install

2. Build the server:

npm run build

3. Start the server:

npm start

Development

For development with auto-rebuild:

npm run dev

Claude Desktop Configuration

To use this MCP server with Claude Desktop, add the following to your Claude Desktop configuration file (located at `~/.claude-config.json`):

{
  "mcpServers": {
    "ferengi-rules-of-acquisition-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/your/server/build/index.js"
      ]
    }
  }
}

Replace `/absolute/path/to/your/server/` with the actual path to your server directory.

Usage Examples

Once connected to Claude Desktop, you can:

1. Get a specific rule: "Can you get Rule 34 from the Ferengi Rules?"

2. Search by theme: "Show me all rules about profit"

3. Get a random rule: "Give me a random Ferengi rule"

4. List themes: "What themes are available in the Rules of Acquisition?"

File Structure

• `index.ts` - Main server implementation
• `ferengi_rules_mcp.json` - The rules data (must be in the same directory)
• `package.json` - Dependencies and scripts
• `tsconfig.json` - TypeScript configuration

Requirements

• Node.js 18+
• The `ferengi_rules_mcp.json` file must be in the same directory as the built server

Troubleshooting

If the server fails to start, ensure:

1. `ferengi_rules_mcp.json` is in the correct location

2. All dependencies are installed (`npm install`)

3. The server is built (`npm run build`)

4. You're using the correct path in Claude Desktop configuration