DollhouseMCP

Instructions

Implementation Reference

• src/server/ServerSetup.ts:58-60 (registration)

  Registers the collection tools including 'get_collection_content' by calling getCollectionTools on the server instance.

  // Register collection tools
  this.toolRegistry.registerMany(getCollectionTools(instance));

• src/server/tools/CollectionTools.ts:97-112 (handler)

  Tool handler registration for 'get_collection_content': defines schema, description, and delegates execution to server.getCollectionContent(path).

    tool: {
      name: "get_collection_content",
      description: "Get detailed information about content from the collection. Use this when users ask to 'see details about a persona' or 'show me the creative writer persona'. Personas are a type of content that defines AI behavioral profiles.",
      inputSchema: {
        type: "object",
        properties: {
          path: {
            type: "string",
            description: "The collection path to the AI customization element. Format: 'library/[type]/[element].md' where type is personas, skills, templates, agents, or memories. Example: 'library/skills/code-review.md'.",
          },
        },
        required: ["path"],
      },
    },
    handler: (args: any) => server.getCollectionContent(args.path)
  },

• src/types/mcp.ts:38-40 (schema)

  Zod schema definition for get_collection_content input arguments (path: string).

  export const GetCollectionContentArgsSchema = z.object({
    path: z.string().describe("Path to the content file in the collection repository")
  });

• src/collection/PersonaDetails.ts:23-61 (helper)

  Helper class method implementing the core getCollectionContent logic: fetches file from GitHub API, decodes base64, sanitizes content, securely parses YAML frontmatter, validates metadata, and returns structured metadata and content.

  async getCollectionContent(path: string): Promise<{ metadata: PersonaMetadata; content: string }> {
    const url = `${this.baseUrl}/${path}`;
    
    const data = await this.githubClient.fetchFromGitHub(url);
    
    if (data.type !== 'file') {
      throw new Error('Path does not point to a file');
    }
    
    // Decode Base64 content
    const content = Buffer.from(data.content, 'base64').toString('utf-8');
    
    // Sanitize content for display (this is view-only, not installation)
    const sanitizedContent = ContentValidator.sanitizePersonaContent(content);
    
    // Use secure YAML parser
    let parsed;
    try {
      parsed = SecureYamlParser.safeMatter(sanitizedContent);
    } catch (error) {
      if (error instanceof SecurityError) {
        throw new Error(`Security warning: This content contains potentially malicious content - ${error.message}`);
      }
      throw error;
    }
    
    const metadata = parsed.data as PersonaMetadata;
    
    // Additional validation for display
    const metadataValidation = ContentValidator.validateMetadata(metadata);
    if (!metadataValidation.isValid && metadataValidation.severity === 'critical') {
      throw new Error(`Security warning: This content contains potentially malicious content`);
    }
    
    return {
      metadata,
      content: parsed.content
    };
  }