@zyzy-org/blog-mcp-server 1.0.0 → 1.0.1

package/DEPLOYMENT.md

@@ -0,0 +1,99 @@
+# 部署说明 / Deployment Guide
+
+## 中文版 / Chinese Version
+
+### 发布到 npm
+
+```bash
+# 构建项目
+npm run build
+
+# 发布包
+npm run publish-package
+```
+
+### 发布到 GitHub
+
+```bash
+# 初始化 Git 仓库（如果还没有）
+git init
+
+# 添加文件
+git add .
+
+# 提交更改
+git commit -m "Initial commit: Blog MCP Server"
+
+# 添加远程仓库
+git remote add origin https://github.com/zyzy-org/blog-mcp-server.git
+
+# 推送到 GitHub
+git push -u origin main
+```
+
+### 注意事项
+
+1. **敏感信息保护** - 确保 `.env` 文件已添加到 `.gitignore`
+2. **环境变量** - 所有敏感配置都通过环境变量管理
+3. **私人服务** - 这是私人 MCP 服务，不对外公开
+4. **测试** - 发布前请确保所有功能正常工作
+
+### 版本更新
+
+```bash
+# 更新版本号
+npm version patch  # 或 minor, major
+
+# 重新发布
+npm run publish-package
+```
+
+---
+
+## English Version
+
+### Publishing to npm
+
+```bash
+# Build the project
+npm run build
+
+# Publish the package
+npm run publish-package
+```
+
+### Publishing to GitHub
+
+```bash
+# Initialize Git repository (if not already done)
+git init
+
+# Add files
+git add .
+
+# Commit changes
+git commit -m "Initial commit: Blog MCP Server"
+
+# Add remote repository
+git remote add origin https://github.com/zyzy-org/blog-mcp-server.git
+
+# Push to GitHub
+git push -u origin main
+```
+
+### Important Notes
+
+1. **Sensitive Information Protection** - Ensure `.env` file is added to `.gitignore`
+2. **Environment Variables** - All sensitive configurations are managed through environment variables
+3. **Private Service** - This is a private MCP service, not publicly available
+4. **Testing** - Please ensure all functionality works properly before publishing
+
+### Version Updates
+
+```bash
+# Update version number
+npm version patch  # or minor, major
+
+# Republish
+npm run publish-package
+```

package/README.md

@@ -1,147 +1,252 @@
 # Blog MCP Server
 
-> 自动在你的技术博客中创建文章的 MCP 服务器
+<div align="center">
 
-这个 MCP (Model Context Protocol) 服务器允许 AI 助手（如 Cursor、Claude 等）直接在你的技术博客中创建文章，无需手动编辑。
+[README.md for Chinese version](./README.md) 
 
-## 🎯 项目目标
+</div>
 
-参考 [Supabase MCP](https://github.com/supabase-community/supabase-mcp) 的项目结构，创建一个完整的、可发布的 MCP 服务包，让 AI 助手能够直接在你的博客中创建文章。
+> Private MCP Server - Let AI assistants create articles directly in your tech blog
 
-## ✨ 功能特性
+This is a private MCP (Model Context Protocol) server customized for your blog, allowing AI assistants (such as Cursor, Claude, etc.) to create articles directly in your tech blog without manual editing.
 
-- 🚀 **自动创建文章**: AI 可以直接创建完整的博客文章
-- 📝 **Markdown 支持**: 支持完整的 Markdown 格式
-- 🏷️ **标签管理**: 自动创建和管理文章标签
-- 🔒 **安全认证**: 支持签名验证和客户端白名单
-- 📦 **批量操作**: 支持批量创建多篇文章
-- ⚡ **实时发布**: 文章创建后立即可见
-- 🔧 **TypeScript**: 完整的类型安全支持
-- 📦 **npm 包**: 可直接通过 npx 安装使用
+## 🎯 Project Features
 
-## 🚀 快速开始
+- 🔒 **Private Service** - Customized for your blog, not publicly available
+- 🚀 **Automated Creation** - AI can create complete blog articles directly
+- 📝 **Markdown Support** - Full Markdown format support
+- 🏷️ **Tag Management** - Automatic creation and management of article tags
+- 🔐 **Security Authentication** - Multi-layer security verification mechanism
+- 📦 **npm Package** - Can be installed directly via npx
+- ⚡ **Real-time Publishing** - Articles are immediately visible after creation
 
-### 1. 配置环境变量
+## 🚀 Quick Start
 
-复制 `.env.example` 为 `.env` 并填入你的配置：
+### 1. Configure in Cursor
 
-```bash
-cp .env.example .env
-# 编辑 .env 文件，填入你的实际配置
+Add the following configuration to your Cursor settings file `~/.cursor/mcp.json`:
+
+```json
+{
+  "Blog MCP Server": {
+    "type": "stdio",
+    "command": "npx",
+    "args": [
+      "-y",
+      "@zyzy-org/blog-mcp-server@latest"
+    ],
+    "env": {
+      "BLOG_URL": "https://your-blog.com",
+      "MCP_SECRET": "your_shared_secret_here",
+      "MCP_CLIENT_ID": "your_client_id",
+      "MCP_SIGNATURE_SECRET": "your_signature_secret"
+    }
+  }
+}
 ```
 
-### 2. 在 Cursor 中配置
+### 2. Restart Cursor
 
-在你的 Cursor 设置中添加以下 MCP 服务器：
+After configuration, restart Cursor to activate the new MCP server.
 
-#### 生产环境
-```bash
-npx -y @zyzy-org/blog-mcp-server@latest
-```
+### 3. Start Using
 
-#### 本地开发
-```bash
-npx -y @zyzy-org/blog-mcp-server@latest --local
+Use directly in Cursor:
+
+```
+Please create an article about React Hooks in my blog
 ```
 
-## ⚙️ 配置参数
+## 🛠️ Available Tools
 
-### 环境变量配置（推荐）
-在 `.env` 文件中配置：
+### create_blog_post
+Create a single blog article
+
+**Parameters:**
+- `title` (string): Article title (required)
+- `content` (string): Article content, supports Markdown (required)
+- `tags` (array): Article tags (optional)
+- `author` (string): Author name (optional)
+- `readTime` (number): Estimated reading time in minutes (optional)
+- `date` (string): Publication date (ISO 8601 format) (optional)
+- `github_url` (string): Related GitHub link (optional)
+- `slug` (string): Custom article slug (optional)
 
-- `BLOG_URL`: 你的博客 API 地址（必需）
-- `MCP_SECRET`: MCP 共享密钥（必需）
-- `MCP_CLIENT_ID`: 客户端标识（可选，默认为 'blog-mcp-client'）
-- `MCP_SIGNATURE_SECRET`: 签名密钥（可选，用于额外安全验证）
-- `BLOG_LOCAL_URL`: 本地开发地址（可选）
+### create_multiple_blog_posts
+Create multiple blog articles in batch
+
+**Parameters:**
+- `articles` (array): Array of articles to create
+
+## 🔒 Security Features
+
+- **Shared Secret Authentication** - Uses pre-configured keys for basic authentication
+- **Timestamp Verification** - Prevents replay attacks
+- **Signature Verification** - Optional additional security layer
+- **Client Whitelist** - Restricts allowed client access
+- **Environment Variable Management** - All sensitive information stored in environment variables
+
+## 🏗️ Blog End Configuration
+
+### 1. API Endpoint
+
+Create `/app/api/mcp/posts/route.ts` in your Next.js blog project:
+
+```typescript
+import { NextRequest, NextResponse } from 'next/server';
+import { createAdminClient } from '@/lib/supabase/admin';
+
+export async function POST(req: NextRequest) {
+  const secret = process.env.MCP_SHARED_SECRET;
+  if (!secret) {
+    return NextResponse.json({ error: 'Server not configured' }, { status: 500 });
+  }
+
+  // Basic secret verification
+  const provided = req.headers.get('x-mcp-secret');
+  if (!provided || provided !== secret) {
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+  }
+
+  let body;
+  try {
+    body = await req.json();
+  } catch {
+    return NextResponse.json({ error: 'Invalid JSON body' }, { status: 400 });
+  }
+
+  // Client whitelist verification
+  const allowedClients = process.env.MCP_ALLOWED_CLIENTS?.split(',') || [];
+  if (allowedClients.length > 0 && body.client_id && !allowedClients.includes(body.client_id)) {
+    return NextResponse.json({ error: 'Client not authorized' }, { status: 403 });
+  }
+
+  // Article creation logic...
+  const admin = createAdminClient();
+  const finalSlug = body.slug ?? crypto.randomUUID();
+
+  try {
+    const { error: postError } = await admin
+      .from('Post')
+      .upsert({
+        slug: finalSlug,
+        title: body.title,
+        date: body.date ?? new Date().toISOString(),
+        author: body.author || '',
+        tags: body.tags || [],
+        content: body.content,
+        readTime: body.readTime === '' ? null : body.readTime,
+        lastModified: new Date().toISOString(),
+        github_url: body.github_url || '',
+        isShown: true,
+      }, { onConflict: 'slug' });
+
+    if (postError) {
+      return NextResponse.json({ error: 'Failed to create post', details: postError.message }, { status: 500 });
+    }
+
+    return NextResponse.json({ slug: finalSlug, message: 'ok' });
+  } catch (e) {
+    const errorMessage = e instanceof Error ? e.message : String(e);
+    return NextResponse.json({ error: 'Unexpected error', details: errorMessage }, { status: 500 });
+  }
+}
+```
 
-### 命令行参数（可选）
-- `--blog-url`: 覆盖环境变量中的博客地址
-- `--secret`: 覆盖环境变量中的密钥
-- `--client-id`: 覆盖环境变量中的客户端ID
-- `--signature-secret`: 覆盖环境变量中的签名密钥
-- `--local`: 使用本地开发环境
+### 2. Environment Variable Configuration
 
-## 🛠️ 可用工具
+Configure the following environment variables in Vercel:
 
-### create_blog_post
-创建单篇博客文章
-
-**参数:**
-- `title` (string): 文章标题
-- `content` (string): 文章内容（Markdown 格式）
-- `tags` (array): 文章标签
-- `author` (string): 作者名称
-- `readTime` (number): 预计阅读时间（分钟）
-- `date` (string): 发布日期（ISO 8601 格式）
-- `github_url` (string): 相关的 GitHub 链接
-- `slug` (string): 自定义文章 slug
+```bash
+# MCP Authentication Configuration
+MCP_SHARED_SECRET=your_shared_secret_here
+MCP_CLIENT_ID=your_client_id
+MCP_SIGNATURE_SECRET=your_signature_secret
+MCP_ALLOWED_CLIENTS=client1,client2,client3
+
+# Supabase Configuration
+SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
+```
 
-### create_multiple_blog_posts
-批量创建多篇博客文章
+### 3. Middleware Configuration
 
-**参数:**
-- `articles` (array): 要创建的文章数组
+Ensure `middleware.ts` excludes API routes:
 
-## 🔒 安全特性
+```typescript
+export const config = {
+  matcher: [
+    "/((?!_next/static|_next/image|favicon.ico|api|categories|post/|write|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)",
+  ],
+};
+```
 
-- 使用共享密钥进行基础认证
-- 支持时间戳验证防止重放攻击
-- 可选的签名验证提供额外安全层
-- 支持客户端白名单限制访问
-- 完整的错误处理和日志记录
+## 🧪 Testing
 
-## 🧪 测试
+### Local Testing
 
 ```bash
-# 构建项目
+# Build project
 npm run build
 
-# 启动 MCP 服务器
+# Start MCP server
 npm start
 
-# 或者直接运行
-node dist/index.js
+# Test configuration
+npm test
 ```
 
-## 🛠️ 开发
+### API Testing
 
 ```bash
-# 安装依赖
-npm install
-
-# 构建
-npm run build
-
-# 开发模式
-npm run dev
-
-# 本地测试
-npm run test
+curl -X POST https://your-blog.com/api/mcp/posts \
+  -H "Content-Type: application/json" \
+  -H "x-mcp-secret: your_shared_secret_here" \
+  -d '{
+    "title": "Test Article",
+    "content": "This is a test article",
+    "client_id": "your_client_id"
+  }'
 ```
 
-## 📁 项目结构
+## 📁 Project Structure
 
 ```
 src/
-├── index.ts          # 主入口文件
-├── types.ts          # 类型定义
-├── config.ts         # 配置解析
-├── blog-client.ts    # 博客 API 客户端
-├── mcp-server.ts     # MCP 服务器实现
-└── tools.ts          # MCP 工具定义
+├── index.ts          # Main entry file
+├── types.ts          # Type definitions
+├── config.ts         # Configuration parsing
+├── blog-client.ts    # Blog API client
+└── mcp-server.ts     # MCP server implementation
 ```
 
-## 📚 相关文档
+## 🚨 Important Notes
+
+1. **Private Service** - This is a private service customized for your blog, not publicly available
+2. **Key Security** - All sensitive information is stored in environment variables, do not commit to code repository
+3. **Regular Updates** - It's recommended to regularly rotate signature keys
+4. **Local Testing** - It's recommended to test functionality in local environment first
+
+## 🎉 Usage Examples
 
-- [USAGE.md](./USAGE.md) - 详细使用指南
-- [PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md) - 项目结构说明
-- [example-config.md](./example-config.md) - 配置示例
+After configuration, you can use it in Cursor like this:
+
+### Create Single Article
+```
+Please create an article about TypeScript in my blog with the title "TypeScript Best Practices"
+```
+
+### Create Multiple Articles
+```
+Please create three articles about React in my blog:
+1. React Hooks Deep Dive
+2. React Performance Optimization
+3. React State Management
+```
 
-## 🤝 贡献
+## 📄 License
 
-欢迎提交 Issue 和 Pull Request！
+MIT License - See [LICENSE](./LICENSE) file for details
 
-## 📄 许可证
+---
 
-MIT License - 详见 [LICENSE](./LICENSE) 文件
+**Note**: This is a private MCP service customized for your blog. All sensitive configuration information is stored in environment variables to ensure security.

package/README_CN.md

@@ -0,0 +1,252 @@
+# Blog MCP Server
+
+<div align="center">
+
+[README_EN.md 查看英文版](./README_EN.md) 
+
+</div>
+
+> 私人 MCP 服务器 - 让 AI 助手直接在你的技术博客中创建文章
+
+这是一个专为你的博客定制的私人 MCP (Model Context Protocol) 服务器，允许 AI 助手（如 Cursor、Claude 等）直接在你的技术博客中创建文章，无需手动编辑。
+
+## 🎯 项目特点
+
+- 🔒 **私人服务** - 专为你的博客定制，不对外公开
+- 🚀 **自动化创建** - AI 可以直接创建完整的博客文章
+- 📝 **Markdown 支持** - 支持完整的 Markdown 格式
+- 🏷️ **标签管理** - 自动创建和管理文章标签
+- 🔐 **安全认证** - 多层安全验证机制
+- 📦 **npm 包** - 可直接通过 npx 安装使用
+- ⚡ **实时发布** - 文章创建后立即可见
+
+## 🚀 快速开始
+
+### 1. 在 Cursor 中配置
+
+在你的 Cursor 设置文件 `~/.cursor/mcp.json` 中添加以下配置：
+
+```json
+{
+  "Blog MCP Server": {
+    "type": "stdio",
+    "command": "npx",
+    "args": [
+      "-y",
+      "@zyzy-org/blog-mcp-server@latest"
+    ],
+    "env": {
+      "BLOG_URL": "https://your-blog.com",
+      "MCP_SECRET": "your_shared_secret_here",
+      "MCP_CLIENT_ID": "your_client_id",
+      "MCP_SIGNATURE_SECRET": "your_signature_secret"
+    }
+  }
+}
+```
+
+### 2. 重启 Cursor
+
+配置完成后，重启 Cursor 以使新的 MCP 服务器生效。
+
+### 3. 开始使用
+
+在 Cursor 中直接使用：
+
+```
+请在我的博客中创建一篇关于 React Hooks 的文章
+```
+
+## 🛠️ 可用工具
+
+### create_blog_post
+创建单篇博客文章
+
+**参数:**
+- `title` (string): 文章标题（必需）
+- `content` (string): 文章内容，支持 Markdown（必需）
+- `tags` (array): 文章标签（可选）
+- `author` (string): 作者名称（可选）
+- `readTime` (number): 预计阅读时间（分钟）（可选）
+- `date` (string): 发布日期（ISO 8601 格式）（可选）
+- `github_url` (string): 相关的 GitHub 链接（可选）
+- `slug` (string): 自定义文章 slug（可选）
+
+### create_multiple_blog_posts
+批量创建多篇博客文章
+
+**参数:**
+- `articles` (array): 要创建的文章数组
+
+## 🔒 安全特性
+
+- **共享密钥认证** - 使用预配置的密钥进行基础认证
+- **时间戳验证** - 防止重放攻击
+- **签名验证** - 可选的额外安全层
+- **客户端白名单** - 限制允许的客户端访问
+- **环境变量管理** - 所有敏感信息存储在环境变量中
+
+## 🏗️ 博客端配置
+
+### 1. API 端点
+
+在你的 Next.js 博客项目中创建 `/app/api/mcp/posts/route.ts`：
+
+```typescript
+import { NextRequest, NextResponse } from 'next/server';
+import { createAdminClient } from '@/lib/supabase/admin';
+
+export async function POST(req: NextRequest) {
+  const secret = process.env.MCP_SHARED_SECRET;
+  if (!secret) {
+    return NextResponse.json({ error: 'Server not configured' }, { status: 500 });
+  }
+
+  // 基础密钥验证
+  const provided = req.headers.get('x-mcp-secret');
+  if (!provided || provided !== secret) {
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+  }
+
+  let body;
+  try {
+    body = await req.json();
+  } catch {
+    return NextResponse.json({ error: 'Invalid JSON body' }, { status: 400 });
+  }
+
+  // 客户端白名单验证
+  const allowedClients = process.env.MCP_ALLOWED_CLIENTS?.split(',') || [];
+  if (allowedClients.length > 0 && body.client_id && !allowedClients.includes(body.client_id)) {
+    return NextResponse.json({ error: 'Client not authorized' }, { status: 403 });
+  }
+
+  // 创建文章逻辑...
+  const admin = createAdminClient();
+  const finalSlug = body.slug ?? crypto.randomUUID();
+
+  try {
+    const { error: postError } = await admin
+      .from('Post')
+      .upsert({
+        slug: finalSlug,
+        title: body.title,
+        date: body.date ?? new Date().toISOString(),
+        author: body.author || '',
+        tags: body.tags || [],
+        content: body.content,
+        readTime: body.readTime === '' ? null : body.readTime,
+        lastModified: new Date().toISOString(),
+        github_url: body.github_url || '',
+        isShown: true,
+      }, { onConflict: 'slug' });
+
+    if (postError) {
+      return NextResponse.json({ error: 'Failed to create post', details: postError.message }, { status: 500 });
+    }
+
+    return NextResponse.json({ slug: finalSlug, message: 'ok' });
+  } catch (e) {
+    const errorMessage = e instanceof Error ? e.message : String(e);
+    return NextResponse.json({ error: 'Unexpected error', details: errorMessage }, { status: 500 });
+  }
+}
+```
+
+### 2. 环境变量配置
+
+在 Vercel 中配置以下环境变量：
+
+```bash
+# MCP 认证配置
+MCP_SHARED_SECRET=your_shared_secret_here
+MCP_CLIENT_ID=your_client_id
+MCP_SIGNATURE_SECRET=your_signature_secret
+MCP_ALLOWED_CLIENTS=client1,client2,client3
+
+# Supabase 配置
+SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
+```
+
+### 3. 中间件配置
+
+确保 `middleware.ts` 排除 API 路由：
+
+```typescript
+export const config = {
+  matcher: [
+    "/((?!_next/static|_next/image|favicon.ico|api|categories|post/|write|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)",
+  ],
+};
+```
+
+## 🧪 测试
+
+### 本地测试
+
+```bash
+# 构建项目
+npm run build
+
+# 启动 MCP 服务器
+npm start
+
+# 测试配置
+npm test
+```
+
+### API 测试
+
+```bash
+curl -X POST https://your-blog.com/api/mcp/posts \
+  -H "Content-Type: application/json" \
+  -H "x-mcp-secret: your_shared_secret_here" \
+  -d '{
+    "title": "测试文章",
+    "content": "这是一篇测试文章",
+    "client_id": "your_client_id"
+  }'
+```
+
+## 📁 项目结构
+
+```
+src/
+├── index.ts          # 主入口文件
+├── types.ts          # 类型定义
+├── config.ts         # 配置解析
+├── blog-client.ts    # 博客 API 客户端
+└── mcp-server.ts     # MCP 服务器实现
+```
+
+## 🚨 重要提醒
+
+1. **私人服务** - 这是专为你的博客定制的私人服务，不对外公开
+2. **密钥安全** - 所有敏感信息都存储在环境变量中，不要提交到代码仓库
+3. **定期更新** - 建议定期更换签名密钥
+4. **本地测试** - 建议先在本地环境测试功能
+
+## 🎉 使用示例
+
+配置完成后，你可以在 Cursor 中这样使用：
+
+### 创建单篇文章
+```
+请在我的博客中创建一篇关于 TypeScript 的文章，标题为"TypeScript 最佳实践"
+```
+
+### 批量创建文章
+```
+请在我的博客中创建三篇关于 React 的文章：
+1. React Hooks 详解
+2. React 性能优化
+3. React 状态管理
+```
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](./LICENSE) 文件
+
+---
+
+**注意**: 这是一个私人 MCP 服务，专为你的博客定制。所有敏感配置信息都存储在环境变量中，确保安全性。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zyzy-org/blog-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MCP server for automatically creating blog posts in your tech blog",
   "main": "dist/index.js",
   "bin": {

package/PROJECT_STRUCTURE.md

@@ -1,67 +0,0 @@
-# 项目结构
-
-```
-yy-blog-generate-post-mcp-server/
-├── src/                          # TypeScript 源代码
-│   ├── index.ts                  # 主入口文件
-│   ├── types.ts                  # 类型定义
-│   ├── config.ts                 # 配置解析
-│   ├── blog-client.ts            # 博客 API 客户端
-│   ├── mcp-server.ts             # MCP 服务器实现
-│   └── tools.ts                  # MCP 工具定义
-├── dist/                         # 编译后的 JavaScript 文件
-├── package.json                  # 项目配置和依赖
-├── tsconfig.json                 # TypeScript 配置
-├── README.md                     # 项目说明文档
-├── LICENSE                       # MIT 许可证
-├── PUBLISH.md                    # 发布指南
-├── example-config.md             # 配置示例
-├── test-mcp.js                   # 测试脚本
-└── .gitignore                    # Git 忽略文件
-```
-
-## 核心文件说明
-
-### src/index.ts
-主入口文件，负责启动 MCP 服务器。
-
-### src/config.ts
-解析命令行参数，验证必需配置。
-
-### src/blog-client.ts
-博客 API 客户端，处理与你的博客后端的通信。
-
-### src/mcp-server.ts
-MCP 协议服务器实现，处理 AI 助手的请求。
-
-### src/tools.ts
-定义可用的 MCP 工具（create_blog_post, create_multiple_blog_posts）。
-
-### src/types.ts
-TypeScript 类型定义，确保类型安全。
-
-## 构建和运行
-
-```bash
-# 安装依赖
-npm install
-
-# 构建项目
-npm run build
-
-# 测试配置
-npm test
-
-# 启动服务器
-npm start
-```
-
-## 发布和使用
-
-```bash
-# 发布到 npm
-npm run publish-package
-
-# 在 Cursor 中使用
-npx -y @zyzy-org/blog-mcp-server@latest
-```

package/PUBLISH_GUIDE.md

@@ -1,70 +0,0 @@
-# 发布指南
-
-## 🚀 发布到 npm
-
-### 1. 准备发布
-
-确保你已经完成了以下步骤：
-
-```bash
-# 构建项目
-npm run build
-
-# 测试配置
-npm test
-```
-
-### 2. 登录 npm
-
-```bash
-# 确保使用官方 npm 源
-npm config set registry https://registry.npmjs.org/
-
-# 登录到 npm
-npm login
-```
-
-### 3. 发布包
-
-```bash
-# 发布包
-npm run publish-package
-```
-
-## 📦 包信息
-
-- **包名**: `@zyzy-org/blog-mcp-server`
-- **版本**: 1.0.0
-- **访问权限**: public
-- **描述**: 私人博客 MCP 服务器
-
-## 🔒 安全注意事项
-
-- ✅ `.env` 文件不会被发布（已在 `.gitignore` 中）
-- ✅ 敏感信息只存储在本地环境变量中
-- ✅ 包中只包含必要的源代码和文档
-
-## 🎯 发布后使用
-
-发布成功后，你可以在 Cursor 中使用：
-
-```bash
-npx -y @zyzy-org/blog-mcp-server@latest
-```
-
-## 🚨 故障排除
-
-### npm 认证问题
-如果遇到认证问题，请检查：
-1. 是否使用了正确的 npm 源
-2. 是否已正确登录
-3. 是否有发布权限
-
-### 版本更新
-更新版本时：
-```bash
-npm version patch  # 小版本更新
-npm version minor  # 次版本更新
-npm version major  # 主版本更新
-npm run publish-package
-```

package/SETUP.md

@@ -1,96 +0,0 @@
-# 私人 MCP 服务器设置指南
-
-## 🎯 项目说明
-
-这是一个专为你的博客定制的私人 MCP 服务器，所有敏感信息都存储在 `.env` 文件中，确保安全性。
-
-## 🚀 快速设置
-
-### 1. 环境配置
-
-项目已经为你配置好了 `.env` 文件，包含所有必要的密钥：
-
-```bash
-# 博客配置
-BLOG_URL=https://zyzy.info
-BLOG_LOCAL_URL=http://localhost:3000
-
-# MCP 认证配置
-MCP_SECRET=660649959a92f12949618a919413e83c8aad09afbb39bcc172725583037e6beb
-MCP_CLIENT_ID=my-mcp-client
-MCP_SIGNATURE_SECRET=c20f0c7bd9128d05c53ffc7743f483c21169f1562542c30ea6e6bf127b488e5f
-```
-
-### 2. 在 Cursor 中配置
-
-在你的 Cursor 设置中添加以下 MCP 服务器：
-
-#### 生产环境（推荐）
-```bash
-npx -y @zyzy-org/blog-mcp-server@latest
-```
-
-#### 本地开发
-```bash
-npx -y @zyzy-org/blog-mcp-server@latest --local
-```
-
-## 🛠️ 使用方法
-
-### 创建单篇文章
-```
-请在我的博客中创建一篇关于 React 的文章，标题为"React Hooks 详解"
-```
-
-### 批量创建文章
-```
-请在我的博客中创建三篇关于 TypeScript 的文章：
-1. TypeScript 基础语法
-2. TypeScript 高级特性
-3. TypeScript 最佳实践
-```
-
-## 🔒 安全特性
-
-- ✅ 所有敏感信息存储在 `.env` 文件中
-- ✅ `.env` 文件已添加到 `.gitignore`
-- ✅ 支持签名验证防止篡改
-- ✅ 时间戳验证防止重放攻击
-- ✅ 客户端白名单限制访问
-
-## 🧪 测试
-
-```bash
-# 测试配置是否正确
-npm test
-
-# 构建项目
-npm run build
-
-# 启动服务器
-npm start
-```
-
-## 📁 项目结构
-
-```
-├── src/                    # TypeScript 源代码
-├── dist/                   # 编译后的文件
-├── .env                    # 环境变量配置（包含敏感信息）
-├── .env.example           # 环境变量模板
-├── package.json           # 项目配置
-├── README.md              # 项目说明
-├── USAGE.md               # 使用指南
-└── test-config.js         # 配置测试脚本
-```
-
-## 🚨 重要提醒
-
-1. **不要提交 `.env` 文件** - 它包含敏感信息
-2. **这是私人服务** - 仅适用于你的博客
-3. **定期更新密钥** - 建议定期更换签名密钥
-4. **本地测试** - 建议先在本地环境测试
-
-## 🎉 完成
-
-配置完成后，你就可以在 Cursor 中直接使用 AI 助手创建博客文章了！

package/USAGE.md

@@ -1,89 +0,0 @@
-# 使用指南
-
-## 快速开始
-
-### 1. 配置环境变量
-
-复制 `.env.example` 为 `.env` 并填入你的配置：
-
-```bash
-cp .env.example .env
-# 编辑 .env 文件，填入你的实际配置
-```
-
-### 2. 在 Cursor 中配置
-
-在你的 Cursor 设置中添加以下 MCP 服务器：
-
-#### 生产环境配置
-```bash
-npx -y @zyzy-org/blog-mcp-server@latest
-```
-
-#### 本地开发配置
-```bash
-npx -y @zyzy-org/blog-mcp-server@latest --local
-```
-
-## 可用工具
-
-### create_blog_post
-创建单篇博客文章
-
-**示例用法：**
-```
-请在我的博客中创建一篇关于 TypeScript 的文章，标题为"TypeScript 最佳实践"，包含以下内容：
-- TypeScript 基础语法
-- 类型系统详解
-- 最佳实践建议
-```
-
-### create_multiple_blog_posts
-批量创建多篇博客文章
-
-**示例用法：**
-```
-请在我的博客中创建三篇关于 React 的文章：
-1. React Hooks 详解
-2. React 性能优化
-3. React 状态管理
-```
-
-## 故障排除
-
-### 1. API 连接问题
-
-如果遇到 API 连接问题，请检查：
-
-- 博客是否正在运行
-- API 端点是否正确配置
-- 认证密钥是否正确
-- `.env` 文件配置是否正确
-
-### 2. 生产环境问题
-
-如果生产环境 API 返回登录页面，可能需要：
-
-1. 检查中间件配置
-2. 确保 API 路由正确部署
-3. 验证认证逻辑
-
-### 3. 本地测试
-
-```bash
-# 构建项目
-npm run build
-
-# 启动 MCP 服务器
-npm start
-
-# 或者直接运行
-node dist/index.js
-```
-
-## 安全注意事项
-
-- 不要在公开代码中暴露密钥
-- 定期轮换签名密钥
-- 使用客户端白名单限制访问
-- 监控 API 使用情况

package/example-config.md

@@ -1,34 +0,0 @@
-# 配置示例
-
-## Cursor 设置中的 MCP 配置
-
-在你的 Cursor 设置中添加以下 MCP 服务器：
-
-### 基本配置
-```bash
-npx -y @ziyouzhiyi/blog-mcp-server@latest --blog-url=https://zyzy.info --secret=660649959a92f12949618a919413e83c8aad09afbb39bcc172725583037e6beb
-```
-
-### 完整配置（推荐）
-```bash
-npx -y @ziyouzhiyi/blog-mcp-server@latest --blog-url=https://zyzy.info --secret=660649959a92f12949618a919413e83c8aad09afbb39bcc172725583037e6beb --client-id=my-mcp-client --signature-secret=c20f0c7bd9128d05c53ffc7743f483c21169f1562542c30ea6e6bf127b488e5f
-```
-
-## 参数说明
-
-- `--blog-url`: 你的博客域名（必需）
-- `--secret`: MCP 共享密钥，对应你博客中的 `MCP_SHARED_SECRET`（必需）
-- `--client-id`: 客户端标识，对应你博客中的 `MCP_CLIENT_ID`（可选）
-- `--signature-secret`: 签名密钥，对应你博客中的 `MCP_SIGNATURE_SECRET`（可选，用于额外安全验证）
-
-## 本地开发测试
-
-如果你想在发布前测试，可以：
-
-1. 克隆这个仓库
-2. 运行 `npm install`
-3. 运行 `npm run build`
-4. 使用以下命令测试：
-```bash
-node dist/index.js --blog-url=http://localhost:3000 --secret=your-secret
-```