🛠️ HOWTO: Operating DSOM FastMCP Knowledge Server

This operational guide provides step-by-step instructions for running, configuring, and connecting the DSOM FastMCP Knowledge Server (tools/mcp/server.py) via Model Context Protocol (MCP) to AI IDEs such as Cursor, Claude Desktop, and VSCode.

⚡ 1. Fast Execution Protocol (Rule 16 `uv` Mandate)

The MCP server runs natively in Python using uv with PEP 723 inline script dependencies (mcp, fastmcp, pyyaml). Zero global installation required.

Launching the Stdio MCP Server:

uv run tools/mcp/server.py

🔌 2. IDE Integration & Configuration Guides

A. Cursor IDE (`.cursor/mcp.json` or Settings -> MCP):

Add the following JSON configuration to Cursor under Settings > Features > MCP:

{
  "mcpServers": {
    "dsom-palace": {
      "command": "uv",
      "args": [
        "run",
        "tools/mcp/server.py"
      ],
      "cwd": "${workspaceFolder}"
    }
  }
}

B. Claude Desktop (`claude_desktop_config.json`):

Add the server entry to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "dsom-palace": {
      "command": "uv",
      "args": [
        "run",
        "D:\\Users\\LinuxMalaysia\\Projects\\deep-state-of-mind-for-my-ai\\tools\\mcp\\server.py"
      ]
    }
  }
}

📊 3. Exposed MCP Endpoint Matrix (Resources & Tools)

A. MCP Resources (6 Read-Only Protocol URIs)

Resource URI	Description / Source File
`dsom://brain/state`	Reads condensed DSOM state (`.agents/brain/current_state.dsom`).
`dsom://brain/task`	Reads active session task list (`.agents/brain/task.md`).
`dsom://brain/walkthrough`	Reads session walkthrough anchors (`.agents/brain/walkthrough.md`).
`dsom://governance/agents`	Reads the 27 Constitutional AI Rules (`.agents/AGENTS.md`).
`dsom://openwiki/skeleton`	Reads OpenWiki subsystem rankings (`openwiki/_skeleton.md`).
`dsom://openwiki/quickstart`	Reads OpenWiki master entrypoint (`openwiki/quickstart.md`).

B. MCP Tools (3 Executable Tools)

Tool Name	Parameters	Purpose
`search_palace`	`query: str`	Performs bounded text search over `docs/*.md` (capped at 8,000 chars).
`search_openwiki`	`query: str`	Performs sub-millisecond search over OpenWiki OKF frontmatter metadata (`topics:`, `title:`, `description:`).
`fetch_context7_stream`	`tokens: int = 83688`	Returns the live Context7 LLM RAG context stream endpoint URL.

🧪 4. Troubleshooting & Verification

Verify Python Environment: Ensure uv is installed and accessible on your PATH (uv --version).
Test Server Startup:
uv run tools/mcp/server.py --help

Verify Regression Suite:

uv run --with pyyaml python -m unittest tests/test_okf_frontmatter_bom_reorder.py tests/test_okf_quoting.py tests/test_seo_sitemaps.py tests/test_docs_symlinks.py

🔗 5. References

MCP Server Script: tools/mcp/server.py
Native OpenWiki Emulator: tools/openwiki_emulator.py
OpenWiki Integration Blueprint: docs/governance/OPENWIKI-INTEGRATION-GUIDE.md

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

Reference

Explanation

Governance

⚡ 1. Fast Execution Protocol (Rule 16 `uv` Mandate)

Launching the Stdio MCP Server:

🔌 2. IDE Integration & Configuration Guides

A. Cursor IDE (`.cursor/mcp.json` or Settings -> MCP):

B. Claude Desktop (`claude_desktop_config.json`):

📊 3. Exposed MCP Endpoint Matrix (Resources & Tools)

A. MCP Resources (6 Read-Only Protocol URIs)

B. MCP Tools (3 Executable Tools)

🧪 4. Troubleshooting & Verification

🔗 5. References

​⚡ 1. Fast Execution Protocol (Rule 16 uv Mandate)

​Launching the Stdio MCP Server:

​🔌 2. IDE Integration & Configuration Guides

​A. Cursor IDE (.cursor/mcp.json or Settings -> MCP):

​B. Claude Desktop (claude_desktop_config.json):

​📊 3. Exposed MCP Endpoint Matrix (Resources & Tools)

​A. MCP Resources (6 Read-Only Protocol URIs)

​B. MCP Tools (3 Executable Tools)

​🧪 4. Troubleshooting & Verification

​🔗 5. References

⚡ 1. Fast Execution Protocol (Rule 16 `uv` Mandate)

Launching the Stdio MCP Server:

🔌 2. IDE Integration & Configuration Guides

A. Cursor IDE (`.cursor/mcp.json` or Settings -> MCP):

B. Claude Desktop (`claude_desktop_config.json`):

📊 3. Exposed MCP Endpoint Matrix (Resources & Tools)

A. MCP Resources (6 Read-Only Protocol URIs)

B. MCP Tools (3 Executable Tools)

🧪 4. Troubleshooting & Verification

🔗 5. References