手动发布步骤.md•2.69 kB
# 手动发布步骤
如果自动发布脚本遇到问题,请按以下步骤手动发布:
## 1. 切换到官方NPM源
```bash
# 切换到官方NPM源(重要!)
npm config set registry https://registry.npmjs.org/
# 验证源已切换
npm config get registry
# 应该显示: https://registry.npmjs.org/
```
## 2. 确认NPM登录状态
```bash
npm whoami
# 应该显示: pickstar-2025
```
如果未登录,重新登录:
```bash
npm login
# Username: pickstar-2025
# Password: khazix791029
# Email: zxworkem@163.com
```
## 3. 检查包名可用性
```bash
npm view logo-mcp
# 如果显示错误,说明包名可用
# 如果显示包信息,说明包名已被占用
```
## 3. 构建项目
```bash
npm run build
```
## 4. 发布到NPM
```bash
npm publish --access public
```
## 5. 验证发布
```bash
# 检查NPM页面
# https://www.npmjs.com/package/logo-mcp
# 测试安装
npx logo-mcp
```
## 如果包名被占用的解决方案
### 方案1: 使用scoped包名
修改 `package.json` 中的 `name` 字段:
```json
{
"name": "@pickstar-2025/logo-mcp"
}
```
### 方案2: 使用其他包名
```json
{
"name": "logo-mcp-extractor"
}
```
或
```json
{
"name": "website-logo-mcp"
}
```
## 发布成功后的使用方式
### 用户安装使用
```bash
# 直接运行
npx logo-mcp
# 全局安装
npm install -g logo-mcp
logo-mcp
# 项目中安装
npm install logo-mcp
```
### MCP客户端配置
#### Claude Desktop
配置文件: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"logo-mcp": {
"command": "npx",
"args": ["logo-mcp"]
}
}
}
```
#### Cursor
创建 `.cursorrules` 文件:
```
使用logo-mcp工具提取网站Logo:
- extract_logo: 提取并优化Logo
- analyze_logo_candidates: 分析Logo候选项
```
#### 其他MCP客户端
```json
{
"command": "npx",
"args": ["logo-mcp"],
"description": "网站Logo提取工具"
}
```
## 常见问题解决
### 问题1: 发布权限错误
```bash
npm publish --access public
```
### 问题2: 版本号冲突
修改 `package.json` 中的版本号:
```json
{
"version": "1.0.1"
}
```
### 问题3: 网络问题
```bash
# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com/
# 发布时使用官方源
npm publish --registry https://registry.npmjs.org/
```
## 发布完成检查清单
- [ ] NPM登录成功 (`npm whoami`)
- [ ] 项目构建成功 (`npm run build`)
- [ ] 包发布成功 (`npm publish`)
- [ ] NPM页面可访问
- [ ] 命令行测试通过 (`npx logo-mcp`)
- [ ] GitHub代码已推送
- [ ] MCP客户端配置文档完整
完成所有步骤后,您的Logo MCP工具就可以被全世界的开发者使用了!