Ferengi Rules of Acquisition MCP Server

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