Host (Claude Code)
    │
    ├── Client ←──JSON-RPC──→ context7 Server              
    ├── Client ←──JSON-RPC──→ sequential-thinking Server   
    └── Client ←──JSON-RPC──→ your Server

my-mcp-server/
├── pyproject.toml            # 包定义（必需）
│   ├── name = "mcp-server-xxx"
│   └── version = "1.0.0"
├── src/
│   ├── server.py             # 入口，初始化 FastMCP
│   ├── tools.py              # Tool 定义（单文件，适合 <10 个工具）
│   ├── tools/                # Tool 定义（多文件，按功能拆分）
│   │   ├── __init__.py
│   │   ├── search.py
│   │   └── fetch.py
│   └── resources.py          # Resource 提供者（可选）
└── README.md

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("weather")

@mcp.tool()
async def get_weather(location: str) -> str:
    """Get weather for a location."""
    return f"Weather in {location}: 72°F, Sunny"

if __name__ == "__main__":
    mcp.run(transport="stdio")

{
  "args": [
    "-y",
    "@upstash/context7-mcp"
  ],
  "command": "npx",
  "type": "stdio"
}

skill-name/
├── SKILL.md (必需)
│   ├── YAML frontmatter ──→ 索引层（始终加载，~100 words）
│   │   ├── name: (必需)
│   │   └── description: (必需，唯一触发机制)
│   └── Markdown 正文 ────→ 内容层（触发时加载，建议 <500 行）
└── Bundled Resources (可选) ──→ 内容层（按需加载）
    ├── scripts/      - 可执行脚本（Python/Bash）
    ├── references/   - 参考文档（Claude 判断需要时加载）
    └── assets/       - 输出资源（模板、图片，不加载到上下文）

# ✅ 好的 description（包含触发场景）
description: >
  Comprehensive document creation and editing with tracked changes.
  Use when Claude needs to work with .docx files for:
  (1) Creating new documents, (2) Modifying content,
  (3) Working with tracked changes, (4) Adding comments

# ❌ 差的 description（太模糊）
description: A useful document tool

# PDF Processing

## Quick start
[核心代码示例]

## Advanced features
- **Form filling**: See [FORMS.md](references/FORMS.md)
- **API reference**: See [REFERENCE.md](references/REFERENCE.md)

cloud-deploy/
├── SKILL.md (工作流 + 选择指南)
└── references/
    ├── aws.md    ← 用户选 AWS 时才加载
    ├── gcp.md
    └── azure.md

## Editing documents
For simple edits, modify XML directly.

**For tracked changes**: See [REDLINING.md](references/REDLINING.md)
**For OOXML details**: See [OOXML.md](references/OOXML.md)

用户请求 → Claude 扫描所有 Skill 的 description → 匹配 → 加载 SKILL.md 正文 → 按需加载 references → 执行

// ~/.claude.json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

# 清理 npx 缓存
rm -rf ~/.npm/_npx #（不推荐！不推荐！不推荐！）

# 清理 uvx 缓存
uv cache clean #（不推荐！不推荐！不推荐！）

# 上述的清理会清理系统中所有的缓存，但mcp的缓存位置各有不同，需要主动寻找，且无规律可言，最好还是让cc自己来吧

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory@latest"]  // npx 使用 @latest
    },
    "fetch": {
      "command": "uvx",
      "args": ["--refresh", "mcp-server-fetch"]  // uvx 使用 --refresh
    }
  }
}

// marketplace.json
{
  "name": "my-plugins",
  "plugins": [
    {
      "name": "review-plugin",
      "source": "./plugins/review-plugin",
      "version": "2.1.0"  // ← 需要手动维护
    }
  ]
}

场景：应用主题到 Artifact

├── ~/.claude/skills/theme-factory/
│   └── SKILL.md                    # 主题定义、应用指南
└── ~/.claude/commands/
    └── theme-factory.md            # 内容："Execute the theme-factory skill"

用户输入 /theme-factory 应用深色主题
    ↓
Command 触发 → Claude 加载 SKILL.md → 自主执行

场景：前端专项开发

└── ~/.claude/commands/ccg/
    └── frontend.md                 # 完整工作流定义

用户输入 /ccg:frontend 实现响应式导航栏
    ↓
Claude 加载 frontend.md 内容
    ↓
按照 Command 中定义的 6 个阶段执行：
  1. Prompt 增强（可选）
  2. 研究（代码检索）
  3. 构思（调用 Gemini 分析）
  4. 计划（调用 Gemini 规划）
  5. 执行（Claude 实施）
  6. 优化（调用 Gemini 审查）