English Français العربية

mcpship: check and publish MCP servers

السجل الرسمي الذكاء الاصطناعي والوكلاء

Checks a remote MCP server against the Claude directory rules and guides its publication.

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

التثبيت

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

NPM package mcpship
Claude Code 
claude mcp add mcpship-check-and-publish-mcp-servers -- npx -y mcpship@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcpship-check-and-publish-mcp-servers": {
            "command": "npx",
            "args": [
                "-y",
                "mcpship@0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

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

المحتويات
  1. mcpship
  2. Quick start
  3. Commands
  4. What check tests
  5. Use it from Claude Code
  6. Privacy
  7. License

mcpship

Check a remote MCP server against the Claude connector directory rules, then publish it: npm, the official MCP Registry, a Claude Code plugin repo and the Claude connector directory. One step at a time, for people and for agents.

Quick start

npx mcpship init https://example.com/mcp # writes publish.json; fill in the fields MCPSHIP_TOKEN=<access token or API key> npx mcpship check npx mcpship next # the next step, with the exact command

Commands

CommandWhat it does
init <url>Writes a publish.json template in the current folder
check [url]Tests sign-in discovery, tools and listing; exit code 1 if a rule fails
packetWrites docs/directory/submission.md: the text for each directory form step
nextThe first unfinished step, with the command or click
statusLive state of npm, the MCP Registry, the plugin repo and the directory
done directoryRecords that you submitted the directory form
mcpRuns as a local MCP server over stdio

Add --json for machine-readable output and --dir <path> to point at another folder.

npm counts as published only when you are a maintainer of the package. mcpship asks npm whoami; if you publish with a token instead of npm login, set channels.npm.maintainer to your npm user name in publish.json.

What check tests

RuleFails when
auth.httpsthe server URL is not https
auth.www-authenticatean unauthenticated call does not return 401 with resource_metadata
auth.resource-metadataprotected resource metadata is missing or has no authorization server
auth.as-metadataauthorization server metadata is missing
auth.pkceS256 is not supported
auth.client-registrationneither Dynamic Client Registration nor Client ID Metadata Documents
tools.reachabletools/list fails with the given token (skipped without one)
tools.titlea tool has no title
tools.annotationsa tool has neither readOnlyHint nor destructiveHint
tools.instructionsa description tells the model what to do ("use it first", "you must", "call X")
tools.hidden-texta description holds invisible characters or encoded text
listing.icon-urlthe icon URL is not a public https PNG
listing.pagesdocs, privacy or terms page does not load
listing.lengthsname, one-liner or description is over the form limit, or a field is empty
listing.unpublished-mentiona page tells users to run npx <package> before it is on npm

Warnings: tools.mentions (a description names another tool) and listing.em-dash.

Use it from Claude Code

/plugin marketplace add emanueltns/mcpship /plugin install mcpship@mcpship

Then ask Claude to publish your MCP server. The plugin adds the mcpship tools and a skill that walks through each step.

Privacy

mcpship runs on your machine. It calls your server, the URLs in your publish.json, the MCP Registry API, and whatever npm and gh call. It sends no telemetry. MCPSHIP_TOKEN is read from the environment and never printed.

License

MIT

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

ما هو mcpship: check and publish MCP servers؟

Checks a remote MCP server against the Claude directory rules and guides its publication.

كيف أثبّت mcpship: check and publish MCP servers؟

يعمل على جهازك. في Claude Code: claude mcp add mcpship-check-and-publish-mcp-servers -- npx -y mcpship@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج mcpship: check and publish MCP servers إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل mcpship: check and publish MCP servers مفتوح المصدر؟

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

من يصون mcpship: check and publish MCP servers؟

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

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