简化版MCP服务器

Name: 简化版MCP服务器
Author: celeryhq

作者：celeryhq2 星标更新：2025-10-13

安装使用来源：spider==github.com

项目介绍

简化的MCP服务器

这是一个使用模型上下文协议（MCP）的服务器，它提供了Claude、Cursor、Kiro（以及其他支持MCP的平台）与Simplified的API之间的无缝集成。该服务器使大型语言模型能够通过标准化的MCP工具与Simplified的服务进行交互，从而实现跨多个平台的社交媒体账户管理和帖子创建。

特性

完整的MCP协议支持：基于官方的@modelcontextprotocol/sdk构建
社交媒体管理：全面的社交媒体账户和帖子管理
多平台支持：支持Facebook、Instagram、Twitter、LinkedIn、TikTok、YouTube、Pinterest、Threads、Google Business Profile和Bluesky
类型安全实现：使用TypeScript编写，具有完全类型安全性
强大的错误处理：详细的错误消息和全面的错误处理
可配置的日志记录：用于调试和监控的可调整日志级别
特定平台功能：针对Google Business Profile、TikTok、YouTube、Instagram等的高级平台特定设置
计划支持：创建带有平台特定设置的计划帖子
身份验证管理：安全的API令牌处理，带有自动重试逻辑

安装

先决条件

Node.js 18.0.0或更高版本
npm 8.0.0或更高版本
一个Simplified API令牌

从NPM安装

npm install -g simplified-mcp-server

从源代码安装

git clone https://github.com/celeryhq/simplified-mcp-server.git
cd simplified-mcp-server
npm install
npm run build

打包DXT文件

npm install -g @anthropic-ai/dxt
npx @anthropic-ai/dxt pack

配置

服务器使用环境变量进行配置。在项目根目录中创建一个.env文件，或者在环境中设置这些变量：

必要配置

变量	描述	示例
`SIMPLIFIED_API_TOKEN`	您的Simplified API令牌	`sk_live_abc123...`

可选配置

变量	描述	默认值	选项
`SIMPLIFIED_API_BASE_URL`	Simplified API的基础URL	`https://api.simplified.com`	任何有效的URL
`LOG_LEVEL`	日志详细程度	`info`	`debug`, `info`, `warn`, `error`
`REQUEST_TIMEOUT`	API请求超时时间（毫秒）	`30000`	任何正数
`RETRY_ATTEMPTS`	重试次数	`3`	任何非负数
`RETRY_DELAY`	重试间隔时间（毫秒）	`1000`	任何正数

工作流工具配置

服务器支持动态工作流工具，这些工具会根据可用的工作流自动发现并注册工具。此功能默认禁用，并可通过环境变量启用。

变量	描述	默认值	范围/选项
`WORKFLOWS_ENABLED`	启用动态工作流工具	`false`	`true`, `false`
`WORKFLOW_DISCOVERY_INTERVAL`	自动刷新间隔时间（毫秒）	`0`（禁用）	`0-86400000`（0 = 禁用）
`WORKFLOW_EXECUTION_TIMEOUT`	执行超时时间（毫秒）	`300000`（5分钟）	`1000-3600000`
`WORKFLOW_MAX_CONCURRENT_EXECUTIONS`	最大并发执行数	`10`	`1-100`
`WORKFLOW_FILTER_PATTERNS`	逗号分隔的名称模式	``（无）	通配符模式
`WORKFLOW_STATUS_CHECK_INTERVAL`	状态轮询间隔时间（毫秒）	`5000`	`1000-300000`
`WORKFLOW_RETRY_ATTEMPTS`	失败时的重试次数	`3`	`0-10`

示例配置

# 必需
SIMPLIFIED_API_TOKEN=sk_live_your_token_here

# 可选 - 基本配置
SIMPLIFIED_API_BASE_URL=https://api.simplified.com
LOG_LEVEL=info
REQUEST_TIMEOUT=30000
RETRY_ATTEMPTS=3
RETRY_DELAY=1000

# 可选 - 工作流配置
WORKFLOWS_ENABLED=true
WORKFLOW_DISCOVERY_INTERVAL=300000
WORKFLOW_EXECUTION_TIMEOUT=600000
WORKFLOW_MAX_CONCURRENT_EXECUTIONS=10
WORKFLOW_FILTER_P
ATTERNS=data-*,report-*
WORKFLOW_STATUS_CHECK_INTERVAL=5000
WORKFLOW_RETRY_ATTEMPTS=3

环境特定配置示例

开发环境

# 开发设置以获得更快的反馈
WORKFLOWS_ENABLED=true
WORKFLOW_DISCOVERY_INTERVAL=60000          # 1分钟刷新
WORKFLOW_EXECUTION_TIMEOUT=120000          # 2分钟超时
WORKFLOW_MAX_CONCURRENT_EXECUTIONS=5       # 较低的并发数
WORKFLOW_STATUS_CHECK_INTERVAL=2000        # 2秒轮询
WORKFLOW_RETRY_ATTEMPTS=1                  # 较少的重试次数
LOG_LEVEL=debug

生产环境

# 生产设置以确保稳定性和性能
WORKFLOWS_ENABLED=true
WORKFLOW_DISCOVERY_INTERVAL=600000         # 10分钟刷新
WORKFLOW_EXECUTION_TIMEOUT=600000          # 10分钟超时
WORKFLOW_MAX_CONCURRENT_EXECUTIONS=20      # 较高的并发数
WORKFLOW_STATUS_CHECK_INTERVAL=10000       # 10秒轮询
WORKFLOW_RETRY_ATTEMPTS=5                  # 较多的重试次数
LOG_LEVEL=warn

使用方法

程序化使用

import { SimplifiedMCPServer } from 'simplified-mcp-server';
import { ConfigurationManager } from 'simplified-mcp-server/config';

async function startServer() {
  const config = ConfigurationManager.loadConfig();
  const server = new SimplifiedMCPServer(config);
  await server.start();
}

startServer().catch(console.error);

与Claude集成

将服务器添加到您的Claude MCP配置中：

{
   "mcpServers": {
      "simplified": {
        "command": "node",
        "args": [
          "{PATH_TO_CLONED_REPOSITORY}/dist/cli.js",
          "start"
        ],
        "env": {
          "SIMPLIFIED_API_TOKEN": "your_token_here",
          "SIMPLIFIED_API_BASE_URL": "https://api.simplified.com",
          "LOG_LEVEL": "info",
          "WORKFLOWS_ENABLED": "true",
          "WORKFLOW_EXECUTION_TIMEOUT": "600000"
        }
      }
    }
}

安装DXT扩展：

Extensions -> Advanced settings -> Install Extension...

选择simplified-mcp.dxt文件。添加您的令牌。

与Kiro集成

将服务器添加到您的Kiro MCP配置中：

{
  "mcpServers": {
    "simplified": {
      "command": "simplified-mcp-server",
      "env": {
        "SIMPLIFIED_API_TOKEN": "your_token_here",
        "WORKFLOWS_ENABLED": "true",
        "WORKFLOW_DISCOVERY_INTERVAL": "300000",
        "WORKFLOW_EXECUTION_TIMEOUT": "600000"
      }
    }
  }
}

可用工具

服务器提供全面的社交媒体管理工具，包括特定平台的功能，以及动态工作流工具以扩展功能：

社交媒体工具

用于管理社交媒体账户和帖子的工具。

`get_social_media_accounts`

检索所有连接的社交媒体账户。

参数：

network（可选）：按平台过滤（facebook, instagram, linkedin, tiktok, youtube, pinterest, threads, google, bluesky, tiktokBusiness）

示例：

{
  "name": "get_social_media_accounts",
  "arguments": {
    "network": "instagram"
  }
}

`create_social_media_post`

创建新的社交媒体帖子，带有针对Google、TikTok、Threads、YouTube、Facebook、LinkedIn、Instagram和Pinterest的特定平台设置。

参数：

message（必需）：帖子消息/内容（1-5000个字符）
accountId（必需）：社交媒体账户ID
action（必需）：要执行的操作（schedule, add_to_queue, draft）
date（可选）：帖子的计划日期（格式：YYYY-MM-DD HH:MM）
media（可选）：要附加的媒体文件URL数组（最多10项）
additional（可选）：特定平台的帖子设置和元数据

基本示例：

{
  "name": "create_social_media_post",
  "arguments": {
    "message": "激动地宣布我们的新产品发布！🚀",
    "accountId": "acc_fb123",
    "action": "schedule",
    "date": "2024-01-22 12:00",
    "media": [
      "https://example.com/product-image.jpg",
      "https://example.com/launch-video.mp4"
    ],
    "additional": {}
  }
}

媒体文件

media参数接受指向您的媒体文件的URL字符串数组：

{
  "media": [
    "https://example.com/image1.jpg",
    "https://example.com/video.mp4",
    "https://example.com/image2.png"
  ]
}

媒体要求：

每篇帖子最多10个媒体文件
URL必须是公开可访问的
支持的格式因平台而异（图片：JPG, PNG, GIF；视频：MP4, MOV等）

特定平台功能

additional参数支持特定平台的配置：

Google Business Profile

{
  "additional": {
    "google": {
      "post": {
        "title": "新产品发布",
        "topicType": "OFFER",
        "couponCode": "LAUNCH20",
        "callToActionUrl": "https://example.com/product",
        "callToActionType": "SHOP",
        "termsConditions": "有效至月底"
      }
    }
  }
}

TikTok / TikTok Business

{
  "additional": {
    "tiktok": {
      "post": {
        "brandContent": true,
        "privacyStatus": "PUBLIC_TO_EVERYONE",
        "duetDisabled": false,
        "commentDisabled": false
      },
      "channel": { "value": "direct" },
      "postType": { "value": "video" }
    }
  }
}

YouTube

{
  "additional": {
    "youtube": {
      "post": {
        "title": "产品发布视频",
        "license": "standard",
        "privacyStatus": "public",
        "selfDeclaredMadeForKids": "no"
      },
      "postType": { "value": "short" }
    }
  }
}

Instagram

{
  "additional": {
    "instagram": {
      "postReel": {
        "audioName": "热门音频轨道",
        "shareToFeed": true
      },
      "postType": { "value": "reel" }
    }
  }
}

{
  "additional": {
    "pinterest": {
      "post": {
        "link": "https://example.com/product",
        "title": "惊人的产品",
        "imageAlt": "产品展示图像"
      }
    }
  }
}

{
  "additional": {
    "linkedin": {
      "audience": { "value": "PUBLIC" }
    }
  }
}

Facebook

{
  "additional": {
    "facebook": {
      "postType": { "value": "feed" }
    }
  }
}

Threads

{
  "additional": {
    "threads": {
      "channel": { "value": "direct" }
    }
  }
}

动态工作流工具

服务器支持动态工作流工具，这些工具会根据由workflows-list-tool提供的工作流自动发现并注册工具。此功能允许服务器将基于工作流的功能作为标准MCP工具暴露出来，而无需更改代码。

启用工作流工具

要启用动态工作流工具，请设置以下环境变量：

WORKFLOWS_ENABLED=true

启用后，服务器将：

查询workflows-list-tool以发现可用的工作流
自动为每个发现的工作流注册MCP工具
通过标准MCP工具调用来处理工作流执行
提供运行中的工作流的状态检查能力

工作流工具发现

服务器通过调用workflows-list-tool来发现工作流，该工具应返回一个工作流定义数组。每个工作流必须符合以下模式：

{
  "id": "workflow-123",
  "name": "数据分析工作流",
  "description": "分析数据并生成报告",
  "category": "analytics",
  "version": "1.0.0",
  "inputSchema": {
    "type": "object",
    "properties": {
      "dataset": {
        "type": "string",
        "description": "数据集文件路径"
      },
      "format": {
        "type": "string",
        "enum": ["csv", "json", "xlsx"],
        "description": "数据格式"
      }
    },
    "required": ["dataset"]
  },
  "executionType": "async",
  "metadata": {
    "estimatedDuration": "5-10分钟",
    "resourceRequirements": "中等"
  }
}

使用工作流工具

一旦被发现，工作流工具将出现在标准MCP工具列表中，并且可以像其他工具一样调用：

{
  "name": "workflow-data-analysis-workflow",
  "arguments": {
    "dataset": "/path/to/data.csv",
    "format": "csv"
  }
}

工作流执行流程

工具调用：MCP客户端调用带有参数的工作流工具
执行开始：服务器向工作流执行端点发出POST调用
状态轮询：服务器每1000毫秒至少轮询一次工作流状态
结果返回：服务器以标准MCP格式返回工作流结果

示例行执行响应：

{
  "success": true,
  "data": {
    "workflowId": "workflow-123",
    "executionId": "exec-456",
    "status": "COMPLETED",
    "results": {
      "summary": "分析成功完成",
      "reportUrl": "https://example.com/report.pdf",
      "metrics": {
        "recordsProcessed": 10000,
        "executionTime": "4m 32s"
      }
    }
  }
}

工作流状态检查

服务器提供内置的workflow-status-check工具来监控工作流执行：

{
  "name": "workflow-status-check",
  "arguments": {
    "workflowId": "workflow-123",
    "executionId": "exec-456"
  }
}

状态响应包括：

当前执行状态（RUNNING, COMPLETED, FAILED, CANCELLED）
开始和结束时间
进度信息（如果可用）
输入参数和输出结果
错误详情（如果失败）

工作流配置选项

发现和刷新

# 启用自动工作流发现
WORKFLOWS_ENABLED=true

# 每5分钟刷新一次工作流（300000毫秒）
WORKFLOW_DISCOVERY_INTERVAL=300000

执行管理

# 将工作流执行超时设置为10分钟
WORKFLOW_EXECUTION_TIMEOUT=600000

# 允许最多15个并发工作流执行
WORKFLOW_MAX_CONCURRENT_EXECUTIONS=15

# 每3秒检查一次工作流状态
WORKFLOW_STATUS_CHECK_INTERVAL=3000

工作流筛选

# 仅暴露匹配这些模式的工作流
WORKFLOW_FILTER_PATTERNS=data-*,report-*,analysis-*

# 这将暴露如下工作流：
# - data-processing-workflow
# - report-generation-workflow  
# - analysis-customer-workflow
# 但不包括：
# - admin-cleanup-workflow
# - test-workflow

错误处理

# 对失败的工作流操作最多重试5次
WORKFLOW_RETRY_ATTEMPTS=5

工作流工具示例

数据处理工作流

{
  "name": "workflow-data-processor",
  "arguments": {
    "inputFile": "sales-data-2024.csv",
    "operations": ["clean", "aggregate", "analyze"],
    "outputFormat": "json"
  }
}

报告生成工作流

{
  "name": "workflow-monthly-report",
  "arguments": {
    "month": "2024-01",
    "includeCharts": true,
    "recipients": ["manager@company.com"],
    "format": "pdf"
  }
}

机器学习工作流

{
  "name": "workflow-ml-training",
  "arguments": {
    "dataset": "customer-behavior.csv",