Marketplace MCP Skill

市场MCP技能

Claude构建和部署MCP服务器的技能 FastMCP云.

概述

该技能为使用FastMCP 2创建可部署到FastMCP.cloud市场的生产就绪MCP服务器提供了模式、模板和指导。

安装

将此技能添加到您的Claude代码配置中：

claude mcp add-skill marketplace-mcp-skill

或添加到您的 .claude/settings.json:

{
  "skills": [
    "github:7robots/marketplace-mcp-skill"
  ]
}

用法

在构建MCP服务器时，调用以下技能：

/marketplace-mcp

或者简单地描述你的任务，克劳德会自动使用该技能：

“为GitHub API构建MCP服务器，并将其部署到fastmcp.cloud”

包含什么

技能指南(SKILL.md)

• 快速启动工作流程
• 开发流程
• 工具命名约定
• 响应格式模式
• 错误处理模式
• 密钥管理

参考文档

• FastMCP模式：工具注册、Pydantic模型、分页、HTTP客户端模式
• 部署指导：fastmcp.cloud部署、机密管理、CI/CD

示例服务器(example/)

完整的、可部署的MCP服务器模板，展示了所有最佳实践：

• 5个带有完整文档的示例工具
• JSON和Markdown响应格式
• 分页支持
• 错误处理
• 已准备好进行fastmcp.cloud部署

快速开始

1.创建新的MCP服务器

mkdir my-mcp-server && cd my-mcp-server
uv venv
uv pip install "fastmcp>=2.0.0, str:
    """Tool description."""
    return f"Result: {param}"

if __name__ == "__main__":
    host = os.getenv("MCP_HOST", "0.0.0.0")
    port = int(os.getenv("MCP_PORT", "8000"))
    mcp.run(transport="http", host=host, port=port)

3.本地测试

python server.py
# Or: fastmcp inspect server.py

4.部署到fastmcp.cloud

# Create GitHub repo
gh repo create my-mcp-server --public --source=. --push

# Then visit fastmcp.cloud to connect and deploy

您的服务器将在以下位置可用： https://my-mcp-server.fastmcp.app/mcp

秘密管理

本地开发

创建 .env 文件（从不提交）：

API_KEY=your-secret-key
DATABASE_URL=postgresql://user:pass@host/db

FastMCP云

1. 转到fastmcp.cloud上的项目设置
2. 在“Secrets”下添加环境变量
3. 变量在运行时被加密和注入

外部资源

• FastMCP文档: gofastmcp.com
• FastMCP文档MCP服务器: https://gofastmcp.com/mcp
• FastMCP云: fastmcp.cloud
• MCP协议: 模型上下文协议.io

文件结构

marketplace-mcp-skill/
├── SKILL.md                    # Main skill file for Claude
├── README.md                   # This file
├── reference/
│   ├── fastmcp_patterns.md     # FastMCP 2 implementation patterns
│   └── deployment.md           # Deployment and secrets guide
└── example/
    ├── server.py               # Complete example server
    ├── pyproject.toml          # Dependencies
    └── .gitignore              # Git ignore template

许可证

麻省理工学院