使用说明
inkwell mcp
状态：早期存根 --核心架构已经到位并进行了类型检查，但尚未在生产中进行全面测试。期待突破性的变化。欢迎投稿！
用于时事通讯创建者的MCP服务器——使用AI保存源代码、组织笔记、起草文章。
Pocket+Notion+AI写作助手 对于任何写时事通讯的人来说。
它的作用
- 保存来源 （URL、PDF、笔记、引文）——就像Pocket过去一样
- 使用自动标记进行组织 专家链接
- 准备文章摘要 来自收集的笔记和来源
- 导入您的时事通讯 （Substack、Beehiyv、Ghost、Kit）
- 跟踪统计数据 （浏览量、开放率、参与度）
- 条款草案 借助人工智能和语音克隆
作为一个 MCP服务器 --连接到Claude Desktop、Claude.ai或任何兼容MCP的客户端。
快速开始
# Install
npm install inkwell-mcp
# Start the MCP server (stdio transport)
npx inkwell-mcp serve
# Custom database path
npx inkwell-mcp serve --db ./my-newsletter.db
连接到克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"inkwell": {
"command": "npx",
"args": ["inkwell-mcp", "serve"]
}
}
}
然后问克劳德： “列出我的文章” 或 “保存此源：https://example.com/article"
工具
公开（只读）
| 工具 | 说明 |
|---|---|
list_articles |
列出带有筛选器（状态、类型、分页）的文章 |
get_article |
通过链接的专家按ID或版本号获取文章 |
search_articles |
跨标题、副标题、编辑角度的全文搜索 |
get_articles_since |
自某一日期以来发表的文章 |
list_experts |
列出被引用的专家（按级别、国家筛选） |
get_expert |
带有链接文章的专家详细信息 |
list_tags |
按类别列出标签 |
所有者（需要在托管模式下进行身份验证）
| 工具 | 说明 |
|---|---|
save_source |
将URL另存为编辑源（重复数据消除） |
list_sources |
列出已使用/未使用指标的来源 |
deactivate_source |
将源标记为非活动 |
mark_source_used |
追踪哪篇文章使用了来源 |
add_note |
添加编辑注释（想法、角度、引用、事实、待办事项、大纲） |
list_notes |
列出带过滤器的注释 |
update_note |
更新笔记内容、状态、优先级 |
clear_notes |
删除备注（单个或批量确认） |
prepare_brief |
从笔记+来源生成文章摘要 |
get_stats |
通讯汇总统计 |
import_newsletter |
从Substack、Beehiiv、Ghost或Kit进口 |
draft_article |
从简报+语音模板生成结构化草稿 |
list_voice_templates |
列出可用的写作风格模板 |
数据库
用途 SQLite 默认情况下（零配置，本地文件）。不需要外部服务。
./data/inkwell.db # Created automatically on first run
配置
创建 inkwell.config.ts 在项目根目录中：
export default {
name: 'My Newsletter',
description: 'Editorial intelligence for my newsletter',
watermark: 'Source: My Newsletter | me@example.com',
database: {
type: 'sqlite',
path: './data/newsletter.db',
},
auth: { enabled: false },
tagPatterns: [
{ name: 'AI', category: 'tech', pattern: '\\bAI|artificial intelligence\\b' },
],
};
建筑
src/
mcp.ts # JSON-RPC dispatcher + 20 tools
types.ts # TypeScript interfaces
auth.ts # Simplified auth (owner/public)
config.ts # Config loader
utils.ts # Formatting helpers
db/
sqlite.ts # SQLite adapter (better-sqlite3)
migrations/ # Schema (articles, notes, sources)
tools/ # MCP tools (articles, experts, tags, notes, sources, brief, stats, import, write)
connectors/ # Newsletter importers (Substack, Beehiiv, Ghost, Kit)
voice/ # Voice template loader
local/
stdio.ts # stdio transport for local use
cli/
index.ts # CLI entry point
extension/ # Chrome Extension MV3 (web clipper)
templates/
voice/ # Writing style templates (.md)
docs/ # Setup guides
路线图
- [x] 20个MCP工具（文章、笔记、来源、简报、统计数据、导入、写作）
- [x] 通讯导入连接器（Substack、Beehiiv、Ghost、Kit）
- [x] 人工智能辅助绘图的语音/风格模板
- [x] 浏览器扩展（网络裁剪器）
- []Cloudflare Worker部署（托管模式）
- []多用户辅助适配器
- []通过矢量化进行语义搜索
许可证
麻省理工学院
