使用说明
类型化MCP服务器
用于类型化API集成的模型上下文协议（MCP）服务器，使用TypeScript和Node.js构建。该服务器允许人工智能助手（如克劳德）通过Typefully创建和管理推特草稿。
特性
- 创建草稿：创建单条推文或多条推文线程
- 安排职位：在特定时间安排推文
- 自动功能：启用自动转发和自动插入
- 检索草稿：获取预定和发布的草稿
- 线程支持：使用换行符自动创建线程
先决条件
- Node.js 18.x或更高版本
- 具有API访问权限的Typefully帐户
- 类型化API密钥（从类型化中的“设置”>“集成”获取）
安装
选项1:NPX（推荐）
无需安装即可直接运行：
npx typefully-mcp-server
选项2：全局安装
npm install -g typefully-mcp-server
typefully-mcp-server
选项3：来源
- 克隆存储库：
git clone https://github.com/yourusername/typefully-mcp-server.git
cd typefully-mcp-server
- 安装依赖项：
npm install
- 构建项目：
npm run build
配置
将Typefully API键设置为环境变量：
export TYPEFULLY_API_KEY="your_api_key_here"
或者创建一个 .env 文件：
TYPEFULLY_API_KEY=your_api_key_here
用法
运行服务器
npm start
或用于开发：
npm run dev
Claude桌面集成
将此服务器添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%/Claude/claude_desktop_config.json
选项1：使用NPX（推荐）：
{
"mcpServers": {
"typefully": {
"command": "npx",
"args": ["-y", "typefully-mcp-server"],
"env": {
"TYPEFULLY_API_KEY": "your_api_key_here"
}
}
}
}
选项2：使用绝对节点路径（用于本地开发）：
备注：如果你收到“spawn node ENOONT”错误，Claude Desktop找不到 node 命令。请改用节点的绝对路径：
首先，找到你的节点路径： which node
{
"mcpServers": {
"typefully": {
"command": "/opt/homebrew/opt/nvm/versions/node/v22.16.0/bin/node",
"args": ["/path/to/your/project/dist/index.js"],
"env": {
"TYPEFULLY_API_KEY": "your_api_key_here"
}
}
}
}
可用工具
create_draft
在Typefully上创建新草稿。
参数：
content（必填）：推特内容或帖子threadify（可选）：自动将内容拆分为推文schedule_date（可选）：用于日程安排的ISO日期字符串auto_retweet_enabled（可选）：启用自动转发auto_plug_enabled（可选）：启用自动插入
例子：
Create a tweet: "Hello world! This is my first tweet via MCP."
线程示例：
Create a thread about AI:
"AI is transforming how we work and live.
\n\n\n\n
From automating routine tasks to enabling creative breakthroughs, AI tools are becoming essential.
\n\n\n\n
The key is learning to collaborate with AI rather than compete against it."
备注：通过NPX安装后，您只需告诉Claude：“创建一条推特，说‘来自Typefully MCP的你好！’”它就会自动工作。
get_scheduled_drafts
检索您最近安排的草稿。
例子：
Show me my scheduled tweets.
get_published_drafts
检索您最近发布的草稿。
例子：
Show me my recent published tweets.
线程创建
要创建多条推文线程，请用四个连续的新行分隔单个推文(\n\n\n\n)在你的内容。
发展
脚本
npm run build-构建TypeScript项目npm run dev-在开发模式下运行并自动重新加载npm run lint-运行ESLintnpm run typecheck-运行TypeScript类型检查
项目结构
src/
├── index.ts # Entry point
├── server.ts # MCP server implementation
├── client.ts # Typefully API client
└── types.ts # Type definitions
api参考
此服务器与Typefully API v1。有关API的更多信息，请访问 官方文件.
错误处理
该服务器包括全面的错误处理功能，用于：
- API密钥无效
- 网络故障
- 请求格式错误
- API速率限制
常见问题
Claude Desktop中的“spawn node ENOENT”错误
当Claude Desktop找不到 node 命令，因为GUI应用程序不会继承与终端相同的PATH。
解决方案：在Claude Desktop配置中使用节点的绝对路径：
- 查找您的节点路径：
which node - 在配置中使用完整路径，而不仅仅是“node”
例子：
{
"mcpServers": {
"typefully": {
"command": "/opt/homebrew/opt/nvm/versions/node/v22.16.0/bin/node",
"args": ["/path/to/dist/index.js"],
"env": {
"TYPEFULLY_API_KEY": "your_api_key_here"
}
}
}
}
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 运行测试和梳理
- 提交拉取请求
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
致谢
- 灵感来自 Python类型MCP服务器
- 与 模型上下文协议SDK