Creating MCP Servers

MCP (Model Context Protocol) servers extend Gee-Code with additional tools — database connections, API integrations, filesystem access, and more. When configured, their tools become available alongside Gee-Code’s built-in tools.

Quick Start

Via Tool

CreateMCPServer(
    name="filesystem",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"],
    description="Filesystem access for project files"
)

Via Plugin

Add .mcp.json to your plugin:

{
  "servers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "DATABASE_URL": "postgresql://localhost/mydb" }
    }
  }
}

Via Skill Frontmatter

---
name: db-assistant
mcp_servers:
  - name: postgres
    command: npx
    args: ["-y", "@modelcontextprotocol/server-postgres"]
    env:
      DATABASE_URL: "${POSTGRES_URL}"
---

Configuration Fields

Field	Required	Description
name	Yes	Unique server identifier
command	Yes	Command to run (npx, python, node)
args	No	Command arguments
env	No	Environment variables (supports ${VAR} references)
description	No	Human-readable description

How MCP Tools Appear

MCP tools are registered with a namespaced prefix:

mcp__{server_name}__{tool_name}

For example, a PostgreSQL server named postgres with a query tool appears as mcp__postgres__query. The AI uses these tools naturally based on the task.

Managing Servers

/mcp                    # List configured MCP servers
/mcp list               # Show all servers with status

Delete a server you created:

DeleteMCPServer(server_name="postgres")

Common MCP Servers

Server	Package	Use Case
Filesystem	@modelcontextprotocol/server-filesystem	File access with path constraints
PostgreSQL	@modelcontextprotocol/server-postgres	Database queries
SQLite	@modelcontextprotocol/server-sqlite	Local database access
GitHub	@modelcontextprotocol/server-github	GitHub API integration
Brave Search	@modelcontextprotocol/server-brave-search	Web search

Guardrails Integration

MCP server tools are subject to the same guardrails as built-in tools. If a guardrail blocks a tool name, it applies to MCP tools too.

Next Steps

• Skills & Plugins — the skill system overview
• Building Plugins — bundle MCP servers with plugins
• Validation — code validation setup