OSP 营销工具 for Node.js

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

为什么选择 TypeScript 实现？

这个 TypeScript/Node.js 实现相比原始的 Python 版本提供了显著的优势：

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

非常适合那些希望使用 OSP 营销工具而不必处理 Python 依赖项、虚拟环境或兼容性问题的人。

功能

1. OSP 产品价值图生成器

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

• 战略标语创建和改进
• 市场、技术、用户体验和业务维度的位置声明
• 角色开发，包括角色、挑战和需求
• 价值案例文档，包含明确的好处、挑战和解决方案
• 结构化层次中的功能分类

2. OSP 元信息生成器

创建带有适当关键词放置和 SEO 友好结构的网页内容元数据。此工具提供：

• 文章标题（H1）带有战略关键词放置
• 优化搜索的元标题（50-60 个字符）
• 带有吸引人的价值主张的元描述（155-160 个字符）
• SEO 友好的 URL slug
• 搜索意图分析和优化
• 移动显示考虑

3. OSP 内容编辑代码

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

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

4. OSP 技术写作指南

一种系统化的方法，用于创建具有适当叙述结构和流程的高质量技术内容。该指南涵盖：

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

5. OSP 页面SEO指南

全面的系统，用于优化搜索引擎和用户体验的网页内容。本指南包括：

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

安装

前提条件

• 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"
      ]
    }
  }
}

从源代码设置

# Clone the repository
git clone https://github.com/x51xxx/osp-marketing-tools-mcp.git
cd osp-marketing-tools-mcp

# Install dependencies
npm install

# Build the project
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（可通过PORT环境变量配置）上启动一个Web服务器，通过Server-Sent Events (SSE)暴露MCP API。

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

可用工具

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

可用提示

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

示例用法

与Claude或其他大型语言模型一起使用

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

Review this technical content using OSP editing codes:

Kubernetes is a container orchestration platform. It handles deploying applications and scaling them as needed. There's lots of things it can do. It's really good. You should use it for your applications to make them more resilient.

生成产品价值图时：

Generate an OSP value map for [Product Name] focusing on [target audience] with the following key features: [list features]

Example:
Generate an OSP value map for CloudDeploy focusing on DevOps engineers with these key features:
- Automated deployment pipeline
- Infrastructure as code support
- Real-time monitoring
- Multi-cloud compatibility

直接API集成（SSE）使用

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

这是一个如何程序化地连接到SSE端点的简单示例：

// Connect to SSE endpoint
const source = new EventSource('http://localhost:3000/sse');
let sessionId;

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

// Listen for tool responses
source.addEventListener('toolResponse', (event) => {
    const response = JSON.parse(event.data);
    console.log('Tool response:', response);
});

// Call a tool
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();
}

开发

# Run in development mode (stdio)
npm run dev

# Run in development mode (HTTP/SSE)
npm run dev:sse

项目结构

osp-marketing-tools-mcp/
├── prompts/             # Markdown resources from OSP tools
├── public/              # Static web files for HTTP server
│   └── index.html       # SSE client demo interface
├── src/
│   ├── utils/           # Utility functions
│   │   └── contentReader.ts
│   ├── tools/           # MCP tool implementations
│   │   └── index.ts
│   ├── prompts/         # MCP prompt templates
│   │   └── index.ts
│   ├── resources/       # MCP resource implementations
│   │   └── index.ts
│   ├── index.ts         # Main entry point (stdio)
│   └── http.ts          # HTTP/SSE server
├── dist/                # Compiled JavaScript (generated)
├── package.json
└── tsconfig.json

致谢

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

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

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

许可证

本软件根据Creative Commons Corporation（“Creative Commons”）提供的Attribution-ShareAlike 4.0 International许可证授权。