‹ 首页

mcp-server

@wellapp-ai · 收录于 5 天前 · 上游提交 1 个月前

Guide for creating new MCP server integrations

场景开发mcp服务器构建集成

适合你，如果你需要为 MCP 协议开发新的服务器端集成。

/ 下载安装
https://github.com/wellapp-ai/well/tree/main/cursor-rules/skills/mcp-server ↗
/ 通过 npx 安装 校验哈希
npx oh-my-skill add wellapp-ai/well/mcp-server
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- wellapp-ai/well/mcp-server
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify wellapp-ai/well/mcp-server
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
340GitHub stars
~565上下文体积 · 单文件
索引托管

怎么用

商店整理自技能原文 · 版本 782601c · 表述以原文为准
它做什么

该技能指导你在Cursor中创建新的MCP服务器集成，包括配置文件夹结构、工具描述符和认证方式，以便添加自定义工具（如Notion、Figma等）。

什么时候触发

当你需要为Cursor项目创建新的MCP服务器集成时触发，例如添加Notion、Figma或浏览器控制等功能。

装好后可以这样说
技能将指导创建文件夹、工具描述符和配置。
技能会展示认证模式和配置步骤。
技能会给出文件夹结构和工具定义示例。
技能原文 SKILL.md作者撰写 · MIT · 782601c

MCP Server Creation Guide

Use this skill when creating a new MCP server integration.

MCP Folder Structure

MCPs live in: ~/.cursor/projects/<project>/mcps/<server-name>/

mcps/
├── user-notion/
│   └── tools/
│       ├── API-retrieve-a-page.json
│       └── ...
├── cursor-ide-browser/
│   └── tools/
│       ├── browser_navigate.json
│       └── ...
└── user-n8n-mcp/
    └── tools/
        └── ...
Tool Descriptor Format

Each tool is a JSON file:

{
  "name": "tool-name",
  "description": "What this tool does",
  "arguments": {
    "type": "object",
    "properties": {
      "param1": { "type": "string", "description": "..." }
    },
    "required": ["param1"]
  }
}
Usage Pattern
  1. Read tool descriptor before calling
  2. Use CallMcpTool with server, toolName, arguments
  3. Handle response appropriately
Example Call
CallMcpTool:
  server: "user-notion"
  toolName: "API-retrieve-a-page"
  arguments: { "page_id": "abc123" }
Existing MCPs Reference

| MCP | Capabilities | |-----|--------------| | user-notion | Page/block CRUD, search, comments | | cursor-ide-browser | Navigation, clicks, screenshots, console | | user-n8n-mcp | Workflow search, details, execution | | user-context7 | Library docs lookup | | figma | Design specs, code generation from frames |

Creating a New MCP
  1. Create folder: mcps/<server-name>/tools/
  2. Add tool descriptors as JSON files
  3. Configure server in ~/.cursor/mcp.json
  4. Restart Cursor (Cmd+Shift+P > "Reload Window")
  5. Test with CallMcpTool
Authentication Patterns
Pattern 1: API Token (env block)

For MCPs that use API keys (Notion, n8n):

"mcp-name": {
  "command": "npx",
  "args": ["-y", "@package/mcp-server"],
  "env": {
    "API_KEY": "your-token-here"
  }
}
Pattern 2: URL-based (no auth)

For MCPs that connect to local servers (Figma desktop):

"mcp-name": {
  "url": "http://127.0.0.1:PORT/mcp"
}
Pattern 3: OAuth (remote URL)

For MCPs that use browser OAuth (Figma remote):

"mcp-name": {
  "url": "https://service.com/mcp"
}

After adding, click "Connect" in Cursor MCP settings to authorize.

Troubleshooting

Installation loops infinitely:

  • Cancel and manually edit ~/.cursor/mcp.json
  • Add config block directly, then restart Cursor

MCP not appearing:

  • Check JSON syntax is valid
  • Verify package name is correct
  • Restart Cursor after changes
Best Practices
  • Always read tool schema before calling
  • Handle errors gracefully
  • Use descriptive tool names
  • Document required vs optional parameters
按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。
…