Installation

npm install -g samp-mcp
# or
yarn global add samp-mcp

Requires Node.js ≥ 18 and a functional SA-MP server directory.

Quick Start

1. Configure MCP Client

Add the following to your MCP client configuration (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "samp-mcp": {
      "command": "npx",
      "args": ["-y", "samp-mcp"]
    }
  }
}

2. Connect to Project

Once initialized, tell the AI agent: "Connect to my SAMP server at C:\path\to\server"

3. Initialize AI Agent

Copy and paste this as your first prompt to the AI:

"SAMP Project. Read SAMP_RULES.md and follow encoding rules. Run set_server_root to start."

Tool Categories

Server Management

Pawn Scripting

Plugin & Include Management

Web & Info

Auditing & Diagnostics

Automation

Meta

Features

• Thai Character Support — Native Windows-874 encoding with UTF-8 corruption recovery
• Safe Editing — Automatic backups + partial line range replacement (no truncation bugs)
• Efficient Search — Search across all scripts, fuzzy file find, extract single functions
• Plugin Auto-Install — GitHub release discovery with ZIP auto-extraction
• Web Search — DuckDuckGo integration for SAMP-related queries
• Caching — Project info cached for 5 minutes to reduce token usage
• AI-Powered — Designed for seamless integration with LLMs

License

MIT © Watcharapong Namsaeng