English Français العربية

io.github.cletcher/chaprola

السجل الرسمي الصحة

Serverless API backend: query, JOIN, pivot, batch ops, email, FHIR, programs via HTTP.

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

التثبيت

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

NPM package @chaprola/mcp-server
Claude Code 
claude mcp add chaprola -e 'CHAPROLA_USERNAME=<CHAPROLA_USERNAME>' -e 'CHAPROLA_API_KEY=<your chaprola_api_key>' -- npx -y @chaprola/mcp-server@1.4.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "chaprola": {
            "command": "npx",
            "args": [
                "-y",
                "@chaprola/mcp-server@1.4.3"
            ],
            "env": {
                "CHAPROLA_USERNAME": "<CHAPROLA_USERNAME>",
                "CHAPROLA_API_KEY": "<your chaprola_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • CHAPROLA_USERNAME إلزامي Your Chaprola username (register at https://api.chaprola.org/register)
  • CHAPROLA_API_KEY إلزامي سري Your Chaprola API key (format: chp_ + 64 hex chars)

التوثيق

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

المحتويات
  1. @chaprola/mcp-server
  2. Quick Start
  3. Getting Credentials
  4. Available Tools
  5. Resources
  6. Environment Variables
  7. HIPAA / BAA
  8. Links

@chaprola/mcp-server

MCP server for Chaprola — the agent-first data platform.

Gives AI agents 40 tools for structured data storage, querying, web search, URL fetching, scheduled jobs, and execution through the Model Context Protocol.

Quick Start

Claude Code
claude mcp add chaprola-mcp -e CHAPROLA_USERNAME=yourusername -e CHAPROLA_API_KEY=chp_yourkey -- npx @chaprola/mcp-server

Note: After installing, restart Claude Code to load the MCP server. The server description and tools will then be available to Claude.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "chaprola": {
      "command": "npx",
      "args": ["@chaprola/mcp-server"],
      "env": {
        "CHAPROLA_USERNAME": "yourusername",
        "CHAPROLA_API_KEY": "chp_yourkey"
      }
    }
  }
}
VS Code / Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "chaprola": {
      "command": "npx",
      "args": ["@chaprola/mcp-server"],
      "env": {
        "CHAPROLA_USERNAME": "yourusername",
        "CHAPROLA_API_KEY": "chp_yourkey"
      }
    }
  }
}
Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "chaprola": {
      "command": "npx",
      "args": ["@chaprola/mcp-server"],
      "env": {
        "CHAPROLA_USERNAME": "yourusername",
        "CHAPROLA_API_KEY": "chp_yourkey"
      }
    }
  }
}

Getting Credentials

# Register (returns your API key — save it immediately)
curl -X POST https://api.chaprola.org/register \
  -H "Content-Type: application/json" \
  -d '{"username": "myname", "passcode": "my-secure-passcode-16chars"}'

Or use the chaprola_register tool after connecting.

Available Tools

ToolDescription
chaprola_helloHealth check
chaprola_registerCreate account
chaprola_loginLogin (get new API key)
chaprola_check_usernameCheck username availability
chaprola_delete_accountDelete account + all data
chaprola_sign_baaSign Business Associate Agreement (PHI only)
chaprola_baa_statusCheck BAA status
chaprola_baa_textGet BAA text
chaprola_importImport JSON to Chaprola format
chaprola_import_urlGet presigned upload URL
chaprola_import_processProcess uploaded file
chaprola_import_downloadImport from URL (CSV/Excel/JSON/Parquet)
chaprola_exportExport to JSON
chaprola_listList files
chaprola_compileCompile .CS source to .PR bytecode
chaprola_runExecute .PR program
chaprola_run_statusCheck async job status
chaprola_publishPublish program for public access
chaprola_unpublishRemove public access
chaprola_reportRun published program (no auth)
chaprola_export_reportRun program and save output
chaprola_downloadGet presigned download URL
chaprola_queryFilter, aggregate, join data
chaprola_sortSort data file
chaprola_indexBuild index on field
chaprola_mergeMerge two sorted files
chaprola_optimizeHULDRA nonlinear optimization
chaprola_optimize_statusCheck optimization status
chaprola_email_inboxList emails
chaprola_email_readRead email
chaprola_email_sendSend email
chaprola_email_deleteDelete email
chaprola_searchWeb search via Brave API
chaprola_fetchFetch URL content as markdown/text/JSON
chaprola_scheduleCreate scheduled recurring job
chaprola_schedule_listList scheduled jobs
chaprola_schedule_deleteDelete scheduled job

Resources

The server exposes reference documentation as MCP resources:

  • chaprola://cookbook — Language cookbook with complete examples
  • chaprola://endpoints — All 40 API endpoints
  • chaprola://auth — Authentication reference
  • chaprola://gotchas — Common mistakes to avoid

Environment Variables

VariableRequiredDescription
CHAPROLA_USERNAMEYesYour registered username
CHAPROLA_API_KEYYesYour API key (format: chp_ + 64 hex chars)

HIPAA / BAA

Non-PHI data works without a signed BAA. If handling Protected Health Information (PHI), a human must review and sign the BAA first. The server includes guardrails that warn agents when the BAA is not signed.

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

ما هو io.github.cletcher/chaprola؟

Serverless API backend: query, JOIN, pivot, batch ops, email, FHIR, programs via HTTP.

كيف أثبّت io.github.cletcher/chaprola؟

يعمل على جهازك. في Claude Code: claude mcp add chaprola -e 'CHAPROLA_USERNAME=<CHAPROLA_USERNAME>' -e 'CHAPROLA_API_KEY=<your chaprola_api_key>' -- npx -y @chaprola/mcp-server@1.4.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

من يصون io.github.cletcher/chaprola؟

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

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