NIUMA Premium MCP
Wraps NIUMA shop's session-based REST API into a remote MCP service for purchasing X Premium yearly plans, enabling plan listing, gift eligibility checks, and order creation via natural language.
README
NIUMA Premium MCP
把 NIUMA 店铺的 Session 型 REST API 封装为远程 MCP 服务，仅提供：
- X Premium 年费
- X Premium+ 年费
套餐价格、付款网络和币种从店铺 /context 实时读取；服务不会硬编码价格。
暴露的工具
| 工具 | 用途 |
|---|---|
list_yearly_plans |
查询两个年度套餐、实时价格与付款选项 |
check_gift_eligibility |
检查 X 账号是否具备赠送开通资格 |
get_eligibility_status |
查询异步资格检查状态 |
register_precheck_email |
资格未通过时登记通知邮箱 |
create_yearly_order |
创建 Premium / Premium+ 年费订单 |
get_order |
查询付款与开通状态 |
submit_payment_tx |
提交链上付款交易哈希 |
每个 MCP 会话使用独立 PHP Session Cookie。服务不会把 Cookie 写入日志或返回给调用者。
本地运行
npm install
Copy-Item .env.example .env
npm start
健康检查：GET http://localhost:3000/health
MCP endpoint：http://localhost:3000/mcp
测试
npm test
npm run check
部署
可以部署到支持长期运行 Node.js 或 Docker 的平台。生产环境必须：
- 提供公网
https://域名。 - 保持单实例，或把 Session 存储替换成共享存储并启用会话粘性。
- 设置
WEBSHOP_ORIGIN=https://lanv.niuma.works。 - 设置
WEBSHOP_ENTRY_PATH=/p/niuma。 - 建议设置
ALLOWED_HOSTS为 MCP 服务自己的域名。
Docker：
docker build -t niuma-premium-mcp .
docker run --rm -p 3000:3000 `
-e WEBSHOP_ORIGIN=https://lanv.niuma.works `
-e WEBSHOP_ENTRY_PATH=/p/niuma `
niuma-premium-mcp
部署后的上架 endpoint 应为：
https://你的-MCP-域名/mcp
不要使用 localhost、内网地址、临时隧道或示例占位域名上架。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.