English Français العربية

io.github.benediktgirz/storylenses

السجل الرسمي الإنتاجية

AI cover letter generation for agents. Job analysis, profile matching, narrative letters.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http storylenses 'https://www.storylenses.app/api/mcp/endpoint' --header 'Authorization: <StoryLenses API key (get one at storylenses.app/developers)>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "storylenses": {
            "type": "http",
            "url": "https://www.storylenses.app/api/mcp/endpoint",
            "headers": {
                "Authorization": "<StoryLenses API key (get one at storylenses.app/developers)>"
            }
        }
    }
}
NPM package @storylenses/mcp-server
Claude Code 
claude mcp add storylenses -- npx -y @storylenses/mcp-server@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "storylenses": {
            "command": "npx",
            "args": [
                "-y",
                "@storylenses/mcp-server@0.1.3"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. StoryLenses MCP Server
  2. Tools
  3. Setup
  4. Environment Variables
  5. Example Workflow
  6. Testing
  7. Get an API Key
  8. License

StoryLenses MCP Server

AI-powered cover letter generation for MCP-compatible agents. The first production MCP server for job applications.

Tools

ToolDescription
storylenses_analyze_jobExtract 15+ structured fields from a job posting
storylenses_match_profileMatch a candidate CV against job data
storylenses_generate_letterGenerate a story-driven cover letter
storylenses_quality_checkScore and evaluate a cover letter
storylenses_list_archetypesList available narrative archetypes and tones

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "storylenses": {
      "command": "npx",
      "args": ["-y", "@storylenses/mcp-server"],
      "env": {
        "STORYLENSES_API_KEY": "your-api-key"
      }
    }
  }
}
Cursor / VS Code

Add to .cursor/mcp.json or VS Code MCP settings:

{
  "mcp": {
    "servers": {
      "storylenses": {
        "command": "npx",
        "args": ["-y", "@storylenses/mcp-server"],
        "env": {
          "STORYLENSES_API_KEY": "your-api-key"
        }
      }
    }
  }
}
Docker
docker run -e STORYLENSES_API_KEY=your-key ghcr.io/benediktgirz/storylenses-mcp-server

Environment Variables

VariableRequiredDescription
STORYLENSES_API_KEYYesYour API key from storylenses.app/mcp
STORYLENSES_API_URLNoAPI base URL (default: https://www.storylenses.app)

Example Workflow

// 1. Analyze job posting
const job = await callTool("storylenses_analyze_job", {
  job_url: "https://linkedin.com/jobs/view/12345"
});

// 2. Match candidate profile
const match = await callTool("storylenses_match_profile", {
  job_analysis: job,
  candidate_cv: "Senior engineer with 7 years React experience..."
});

// 3. Generate cover letter
const letter = await callTool("storylenses_generate_letter", {
  job_analysis: job,
  match_data: match,
  candidate_name: "Alex Chen",
  archetype: match.suggestedArchetype
});

// 4. Quality check
const score = await callTool("storylenses_quality_check", {
  letter_text: letter.letter_text,
  job_analysis: job
});

Testing

npm install
STORYLENSES_API_KEY=your-key npm test

Get an API Key

Visit storylenses.app/mcp to get your API key.

  • Free: 10 generations/month
  • Developer ($29/mo): 200 generations
  • Scale ($99/mo): 1,000 generations

License

MIT

الأسئلة الشائعة

ما هو io.github.benediktgirz/storylenses؟

AI cover letter generation for agents. Job analysis, profile matching, narrative letters.

كيف أثبّت io.github.benediktgirz/storylenses؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http storylenses 'https://www.storylenses.app/api/mcp/endpoint' --header 'Authorization: <StoryLenses API key (get one at storylenses.app/developers)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.benediktgirz/storylenses إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.github.benediktgirz/storylenses مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.benediktgirz/storylenses؟

ينشره benediktgirz. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.