> ## Documentation Index
> Fetch the complete documentation index at: https://harisfazillah.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How-To: Run the FastMCP Server

> This guide explains how to configure, start, and debug the local Model Context Protocol (MCP) server to expose the Sovereign Palace to AI editors.

This guide explains how to configure, start, and debug the local Model Context Protocol (MCP) server to expose the Sovereign Palace to AI editors.

## Prerequisites

* **Python 3.11+** and **`uv`** must be installed.
* **MCP client** (e.g. Cursor, Claude Desktop, or Windsurf) running locally.

## Step 1: Start the server

Launch the server using `uv run` to isolate and resolve dependencies dynamically. This starts the JSON-RPC interface over standard input/output (`stdio`):

```bash theme={null}
uv run tools/mcp/server.py

```

## Step 2: Configure AI editors (Cursor / Claude Desktop)

To connect your IDE to the server, append the following configuration block to your client settings.

### Claude Desktop config (`claudedesktopconfig.json`)

Open `~/.code/claude_desktop_config.json` (macOS/Linux) or `%APPDATA%/Claude/claude_desktop_config.json` (Windows) and insert:

```json theme={null}
{
  "mcpServers": {
    "dsom-palace": {
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp[cli]>=1.1.2",
        "--with", "fastmcp>=0.1.0",
        "--with", "pyyaml>=6.0",
        "tools/mcp/server.py"
      ],
      "env": {
        "DSOM_ROOT": "/absolute/path/to/deep-state-of-mind-for-my-ai"
      }
    }
  }
}

```

## Step 3: Verify server functionality

Execute the standard test suite to confirm that the server registers all required resources and tools:

```bash theme={null}
uv run --with pyyaml --with pytest --with mcp==1.2.1 --with fastmcp pytest tests/test_mcp_server.py

```

***

*Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-08-14*
*Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0*


## Related topics

- [🛠️ HOWTO: Operating DSOM FastMCP Knowledge Server](/tools/howto-mcp-server.md)
- [How-To Guides Index](/how-to/index.md)
- [Explanation: OpenWiki & FastMCP Architecture](/explanation/openwiki-mcp-architecture.md)
- [Explanation: Diátaxis Framework Adoption](/explanation/diataxis.md)
- [Tutorial: Getting Started with DSOM Tools](/tutorials/getting-started.md)