Personal

You run a personal MCP server that aggregates multiple tooling modules and lets you continuously add new capabilities. It integrates ShowDoc data retrieval and code generation, Cursor Cloud Agents management, and MarkItDown conversions, all accessible through a unified MCP interface that you can extend over time.

How to use

You interact with the MCP server through the MCP client that connects using the provided command and environment settings. You can start the local MCP process, restart it when you add new tools, and then run individual tools to fetch data, generate code, or convert resources to Markdown. The server exposes a consistent interface for a growing set of modules, so you can mix ShowDoc tools, Cursor Agents APIs, and MarkItDown utilities in a single workflow.

How to install

Prerequisites you need before installation are Python 3.9 or newer and a working shell environment.

1. Install the project in development mode from your project root.

pip install -e .

Additional configuration and startup

Configure the MCP server for the Cursor integration by creating a configuration file that points to the local MCP command and sets the appropriate environment variable for UTF-8 handling.

{
  "mcpServers": {
    "personal-mcp": {
      "command": "personal-mcp",
      "args": [],
      "cwd": ".",
      "env": {
        "PYTHONUTF8": "1"
      }
    }
  }
}

Starting and using the MCP server

After you configure, restart the Cursor client to load the MCP server. You can then run the available MCP tools to perform actions such as fetching ShowDoc data, generating Android or Flutter code, managing Cursor Cloud Agents, or converting resources to Markdown.

Usage patterns and practical tips

• Start by fetching a ShowDoc API tree to understand the available endpoints. - Generate Android or Flutter code from ShowDoc pages to accelerate app development. - Manage Cursor Cloud Agents by listing agents, checking status, and adding follow-up instructions as you iterate on conversations. - Use MarkItDown to convert various resources (web pages, PDFs, images, etc.) into Markdown for easy sharing and documentation.

Security and maintenance notes

Keep the MCP server up to date with the latest tool versions you add. Ensure that the environment variable PYTHONUTF8 is set to enable UTF-8 handling for Python processes, and protect the MCP access surface by running it in a controlled environment. Regularly review the tools you enable to avoid exposing sensitive data unintentionally.

Available tools

fetch_showdoc_apis

Fetches the API tree from ShowDoc, enabling structured access to endpoints.

fetch_showdoc_node_tree

Retrieves a lightweight node tree from ShowDoc for quick navigation.

generate_android_from_showdoc

Generates Android code from ShowDoc definitions, including Entity, Repository, Retrofit interfaces, and OkHttp config.

generate_flutter_from_showdoc

Generates Flutter code from ShowDoc definitions, including Entity, Repository, and Dio service interfaces.

fetch_node_detail_info

Queries detailed information for a specific ShowDoc node.

fetch_node_cookie

Fetches cookies for a specific ShowDoc node to manage authentication sessions.

set_cursor_api_key_tool

Sets and caches the Cursor API Key for authenticated access.

list_cursor_agents_tool

Lists all Cursor Cloud Agents available to you.

get_cursor_agent_status_tool

Retrieves the current status of a Cursor agent.

get_cursor_agent_conversation_tool

Fetches the conversation history for a Cursor agent.

add_cursor_agent_followup_tool

Adds a follow-up instruction to a Cursor agent for subsequent actions.

delete_cursor_agent_tool

Removes a Cursor agent from the system.

get_cursor_api_key_info_tool

Provides information about your Cursor API key.

list_cursor_models_tool

Lists the recommended models for Cursor usage.

list_cursor_repositories_tool

Lists GitHub repositories relevant to Cursor automation.

convert_to_markdown

Converts various resources (URLs, files) into Markdown format, supporting multiple URI schemes.