Strapi MCP Server

Instructions

Implementation Reference

• src/index.ts:1417-1501 (handler)

  The handler logic for the 'strapi_list_servers' tool within the CallToolRequestSchema handler. It validates input, checks configuration, lists available Strapi servers with version details, or provides setup instructions if no servers are configured.

  if (name === "strapi_list_servers") {
      // Validate input using Zod
      const validatedArgs = validateToolInput("strapi_list_servers", args, requestId);
      if (Object.keys(config).length === 0) {
          const exampleConfig = {
              "myserver": {
                  "api_url": "http://localhost:1337",
                  "api_key": "your-jwt-token-from-strapi-admin",
                  "version": "5.*"
              }
          };
  
          result = {
              content: [
                  {
                      type: "text",
                      text: JSON.stringify({
                          error: "No servers configured",
                          help: {
                              message: "No server configuration found. Please create a configuration file.",
                              config_path: CONFIG_PATH,
                              example_config: exampleConfig,
                              setup_steps: [
                                  "Create the .mcp directory: mkdir -p ~/.mcp",
                                  "Create the config file: touch ~/.mcp/strapi-mcp-server.config.json",
                                  "Add your server configuration using the example above",
                                  "Get your JWT token from Strapi Admin Panel > Settings > API Tokens",
                                  "Make sure the file permissions are secure: chmod 600 ~/.mcp/strapi-mcp-server.config.json"
                              ]
                          }
                      }, null, 2),
                  },
              ],
          };
      }
  
      const servers = Object.keys(config).map(serverName => {
          const serverConfig = config[serverName];
          const version = serverConfig.version || "v4"; // Default to v4 if not specified
  
          // Extract major version from different formats: "5.*", "4.1.5", "v4", "4.*"
          let majorVersion: keyof StrapiVersionDifferences;
          if (version.includes('*')) {
              // Handle "5.*" or "4.*" format
              majorVersion = version.split('.')[0] as keyof StrapiVersionDifferences;
          } else if (version.startsWith('v')) {
              // Handle "v4" or "v5" format
              majorVersion = version.substring(1) as keyof StrapiVersionDifferences;
          } else {
              // Handle "4.1.5" or plain "4" format
              majorVersion = version.split('.')[0] as keyof StrapiVersionDifferences;
          }
  
          return {
              name: serverName,
              api_url: serverConfig.api_url,
              version: serverConfig.version,
              version_details: STRAPI_VERSION_DIFFERENCES[majorVersion]
          };
      });
  
      result = {
          content: [
              {
                  type: "text",
                  text: JSON.stringify({
                      servers,
                      config_path: CONFIG_PATH,
                      help: "To add more servers, edit the configuration file at the path shown above.",
                      version_differences: STRAPI_VERSION_DIFFERENCES,
                      user_action_required: {
                          message: "Please specify which server you want to work with by providing the server name in your next command.",
                          example: "For example: 'I want to work with the server \"myserver\"' or 'Use server \"myserver\" for the next operations'",
                          available_servers: servers.map(s => s.name),
                          warning: "Only use servers that are listed in available_servers. Do not attempt to access servers that are not properly configured."
                      },
                      security: {
                          note: "For security reasons, only servers listed in the configuration file can be accessed.",
                          requirement: "Each server must be properly configured with valid credentials before use."
                      }
                  }, null, 2),
              },
          ],
      };
  } else if (name === "strapi_get_content_types") {

• src/index.ts:621-627 (schema)

  The ToolSchemas object that maps 'strapi_list_servers' to its Zod input schema (ListServersSchema, which is an empty object since no parameters are required).

  const ToolSchemas = {
      strapi_list_servers: ListServersSchema,
      strapi_get_content_types: GetContentTypesSchema,
      strapi_get_components: GetComponentsSchema,
      strapi_rest: RestSchema,
      strapi_upload_media: UploadMediaSchema
  } as const;

• src/index.ts:1245-1248 (registration)

  Registration of the 'strapi_list_servers' tool in the ListToolsRequestSchema handler, providing name, description, and input schema.

      name: "strapi_list_servers",
      description: "List all available Strapi servers from the configuration.",
      inputSchema: zodToJsonSchema(ToolSchemas.strapi_list_servers),
  },

• src/index.ts:462-463 (schema)

  Zod schema definition for 'strapi_list_servers' tool input validation. It expects no parameters.

  // Schema for strapi_list_servers tool (no parameters)
  const ListServersSchema = z.object({}).strict();