obs-mcp-server

Instructions

Implementation Reference

• obs-mcp-server.js:426-443 (handler)

  The handler logic for the 'list_sources' tool, which fetches scene items for a given or current scene.

  case "list_sources": {
    let sceneName = args.scene_name;
    if (!sceneName) {
      const { currentProgramSceneName } = await obs.call("GetSceneList");
      sceneName = currentProgramSceneName;
    }
    const { sceneItems } = await obs.call("GetSceneItemList", { sceneName });
    return ok({
      scene: sceneName,
      sources: sceneItems.map((item) => ({
        id: item.sceneItemId,
        name: item.sourceName,
        type: item.sourceType,
        kind: item.inputKind ?? null,
        visible: item.sceneItemEnabled,
      })),
    });
  }

• obs-mcp-server.js:104-116 (registration)

  The registration/definition of the 'list_sources' tool in the TOOLS array.

    name: "list_sources",
    description:
      "List all sources (scene items) in a scene. Defaults to the current scene.",
    inputSchema: {
      type: "object",
      properties: {
        scene_name: {
          type: "string",
          description: "Scene name. Omit to use the current program scene.",
        },
      },
    },
  },