OSP Marketing Tools for Node.js

一套全面的工具，用于基于 Open Strategy Partners 经过验证的方法论进行技术营销内容创建、优化和产品定位。 这是 OSP Marketing Tools 的 MCP 服务器的 TypeScript 实现。

为什么选择 TypeScript 实现？

与原始 Python 版本相比，此 TypeScript/Node.js 实现具有显着优势：

• 简化安装：更少的依赖项和更直接的设置过程
• 跨平台兼容性：在 Windows 上无缝工作，没有常见的 Python 依赖问题
• 更快的性能：Node.js 通常为此类服务器提供更好的性能
• 现代 JavaScript 生态系统：利用强大的 npm 包生态系统
• 更易于集成：更易于与 Web 应用程序和其他 JavaScript 工具集成
• 更低的资源使用率：通常需要更少的内存和系统资源

非常适合那些想要使用 OSP Marketing Tools 而无需处理 Python 依赖项、虚拟环境或兼容性问题的人。

功能

1. OSP 产品价值地图生成器

生成结构化的 OSP 产品价值地图，有效地传达您产品的价值和定位。 此工具提供：

• 战略标语的创建和完善
• 跨市场、技术、UX 和业务维度的定位声明
• 角色、挑战和需求的角色开发
• 具有明确的优势、挑战和解决方案的价值案例文档
• 结构化层次结构中的功能分类

2. OSP 元信息生成器

创建优化的 Web 内容元数据，具有适当的关键字放置和 SEO 友好的结构。 此工具提供：

• 具有战略关键字放置的文章标题 (H1)
• 针对搜索优化的元标题（50-60 个字符）
• 具有引人注目的价值主张的元描述（155-160 个字符）
• SEO 友好的 URL slug
• 搜索意图分析和优化
• 移动显示注意事项

3. OSP 内容编辑代码

应用 OSP 的语义编辑代码 进行全面的内容审查。 此系统提供：

• 范围和叙事结构分析
• 流程和可读性增强
• 风格和措辞优化
• 词语选择和语法验证
• 技术准确性验证
• 包容性语言指导
• 具有前后示例的建设性反馈

4. OSP 技术写作指南

系统地创建高质量的技术内容，具有适当的叙事结构和流程。 该指南涵盖：

• 叙事结构原则和逻辑进展
• 流程优化和内容组织
• 清晰度和精确度的风格指南
• 技术准确性验证
• 内容类型特定指南（教程、参考文档、API 文档）
• 可访问性和国际化最佳实践

5. OSP 页面 SEO 指南

用于优化 Web 内容以进行搜索引擎和用户体验的综合系统。 本指南包括：

• 元内容优化策略
• 内容深度增强技术
• 跨不同查询类型的搜索意图对齐
• 关键字研究和集成协议
• 内部链接最佳实践
• 结构化数据实施
• 内容推广策略

安装

先决条件

• Node.js 18 或更高版本
• npm 或 yarn

设置

您可以通过两种方式安装和使用此软件包：

通过 npm 设置（推荐）

1. 全局安装软件包：

添加到您的 Claude Desktop 配置文件 (claude_desktop_config.json)：

{
  "mcpServers": {
    "ai_think_gate": {
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/osp-marketing-tools-mcp"
      ]
    }
  }
}

从源代码设置

# 克隆存储库
git clone https://github.com/x51xxx/osp-marketing-tools-mcp.git
cd osp-marketing-tools-mcp

# 安装依赖项
npm install

# 构建项目
npm run build

添加到您的 Claude Desktop 配置文件 (claude_desktop_config.json)：

{
  "mcpServers": {
    "osp_marketing_tools": {
      "command": "node",
      "args": [
        "path/to/osp-marketing-tools-mcp/dist/index.js"
      ]
    }
  }
}

Windows 用户注意事项：请确保将 path/to/osp-marketing-tools-mcp 替换为计算机上 osp-marketing-tools-mcp 目录的实际路径。 例如，如果您将存储库克隆到 C:\Users\YourName\Documents\osp-marketing-tools-mcp，则 args 行应如下所示：

"args": ["C:\\Users\\YourName\\Documents\\osp-marketing-tools-mcp\\dist\\index.js"]

此外，请记住在路径中使用双反斜杠 \\ 而不是单反斜杠 \。

用法

在 stdio 模式下运行服务器（适用于 Claude Desktop、Cursor 等）

npm start

在 HTTP/SSE 模式下运行服务器

npm run start:sse

这将在端口 3000 上启动一个 Web 服务器（可通过 PORT 环境变量配置），该服务器通过服务器发送事件 (SSE) 公开 MCP API。

一旦服务器在 HTTP/SSE 模式下运行，您就可以在 http://localhost:3000/ 访问 Web 界面，该界面提供了可用工具的交互式演示。

可用工具

• health_check - 服务器健康状态和资源可用性检查
• get_editing_codes - OSP 编辑代码文档和语义内容审查的使用协议
• get_writing_guide - OSP 写作指南，其中包含创建高质量技术内容的原则
• get_meta_guide - OSP 元信息生成器，用于 Web 内容元数据优化
• get_value_map_positioning_guide - OSP 产品价值地图生成器，用于有效的产品定位
• get_on_page_seo_guide - OSP 页面 SEO 指南，用于全面的内容优化

可用提示

• edit-content - 使用 OSP 编辑代码审查内容，以提高质量和清晰度
• generate-meta - 生成优化的 Web 内容元数据，具有适当的关键字放置
• generate-value-map - 创建结构化的 OSP 价值地图以进行产品定位
• apply-writing-guide - 应用 OSP 写作原则来创建技术内容
• optimize-seo - 应用页面 SEO 策略来优化内容以进行搜索

使用示例

与 Claude 或其他 LLM 一起使用

要使用 OSP 编辑代码来审查内容，只需将此提示发送给 Claude（在配置 MCP 服务器之后）：

使用 OSP 编辑代码审查此技术内容：

Kubernetes 是一个容器编排平台。 它处理部署应用程序并根据需要扩展它们。 它可以做很多事情。 真的很好。 您应该将它用于您的应用程序，以使其更具弹性。

用于生成产品价值地图：

为 [产品名称] 生成一个 OSP 价值地图，重点关注 [目标受众]，并具有以下关键功能：[列出功能]

示例：
为 CloudDeploy 生成一个 OSP 价值地图，重点关注 DevOps 工程师，并具有以下关键功能：
- 自动化部署管道
- 基础设施即代码支持
- 实时监控
- 多云兼容性

与直接 API 集成 (SSE) 一起使用

服务器提供了一个 JavaScript 客户端示例，演示了如何使用服务器发送事件 (SSE) 连接到 MCP 服务器。 当您在 HTTP/SSE 模式下运行服务器时，您可以在 http://localhost:3000/ 访问演示。

这是一个如何以编程方式连接到 SSE 端点的简单示例：

// 连接到 SSE 端点
const source = new EventSource('http://localhost:3000/sse');
let sessionId;

// 监听会话 ID
source.addEventListener('sessionId', (event) => {
    sessionId = JSON.parse(event.data).sessionId;
    console.log(`Connected with session ID: ${sessionId}`);
});

// 监听工具响应
source.addEventListener('toolResponse', (event) => {
    const response = JSON.parse(event.data);
    console.log('Tool response:', response);
});

// 调用工具
async function callTool(name, args = {}) {
    const response = await fetch(`http://localhost:3000/messages?sessionId=${sessionId}`, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            jsonrpc: '2.0',
            id: Date.now().toString(),
            method: 'tools/call',
            params: {
                name: name,
                arguments: args
            }
        })
    });

    return response.json();
}

开发

# 在开发模式下运行 (stdio)
npm run dev

# 在开发模式下运行 (HTTP/SSE)
npm run dev:sse

项目结构

osp-marketing-tools-mcp/
├── prompts/             # 来自 OSP 工具的 Markdown 资源
├── public/              # HTTP 服务器的静态 Web 文件
│   └── index.html       # SSE 客户端演示界面
├── src/
│   ├── utils/           # 实用程序函数
│   │   └── contentReader.ts
│   ├── tools/           # MCP 工具实现
│   │   └── index.ts
│   ├── prompts/         # MCP 提示模板
│   │   └── index.ts
│   ├── resources/       # MCP 资源实现
│   │   └── index.ts
│   ├── index.ts         # 主入口点 (stdio)
│   └── http.ts          # HTTP/SSE 服务器
├── dist/                # 编译的 JavaScript（已生成）
├── package.json
└── tsconfig.json

归属

本软件基于 Open Strategy Partners 开发的内容创建和优化方法。 它实现了他们支持 LLM 的营销工具和专业内容创建框架。

有关更多信息和原始资源，请访问：

1. OSP 写作和编辑指南
2. 编辑代码快速入门指南
3. OSP 免费资源

许可证

本软件已获得 Creative Commons Corporation（“Creative Commons”）的 Attribution-ShareAlike 4.0 International 许可。