filamental-mcp

Name: filamental-mcp
Author: Scottnine

@Scottnine

代码仓库

关于 filamental-mcp

暂无概览

#knowledge-graph #local-first #graph #notes #productivity #vault #desktop #offline #sqlite

基本信息

分类

开发工具

许可证

MIT

运行时

node

传输方式

stdio

发布者

Scottnine

提交者

Scottnine

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "filamental": {
      "command": "npx",
      "args": [
        "filamental-mcp"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is filamental-mcp?

filamental-mcp is a local Model Context Protocol server that connects AI assistants (Claude Desktop, Claude Code) directly to a Filamental knowledge graph. It reads and writes the vault—searching nodes, following connections, creating and updating content—while Filamental is running or closed, and changes are immediately visible when Filamental opens.

How to use filamental-mcp?

Filamental-mcp can be set up through the Filamental app (Settings > AI Integrations > Connect to Claude Desktop) or manually by installing globally (npm install -g filamental-mcp) and adding its configuration to claude_desktop_config.json. For Claude Code, add a .mcp.json at the project root. No --vault argument is needed by default; the server reads the active vault automatically.

Key features of filamental-mcp

Reads the same SQLite index Filamental uses.
Writes both Markdown files and the SQLite index.
Search nodes with full-text across names, notes, properties.
Create, update, and delete nodes and edges.
Get subgraph BFS traversal up to 3 hops.
Automatic vault detection from Filamental.

Use cases of filamental-mcp

Query your knowledge graph with natural language through Claude.
Create new nodes and relationships directly from a chat.
Search and connect information across multiple vaults.
Automate knowledge graph updates without opening Filamental.

FAQ from filamental-mcp

What are the system requirements?

Node.js 22+ and the Filamental desktop app with at least one vault opened (to initialize the SQLite index).

How does filamental-mcp store and sync data?

It opens the SQLite index read-write. Read tools query the index directly; write tools update both the Markdown file on disk and the SQLite index so changes appear immediately when Filamental loads.

What are the known limitations?

The pre-built better-sqlite3 binary is Windows x64 only; other platforms require building from source.
The server must be restarted if you change the active vault in Filamental.
Auto-config via Filamental Settings has been tested on Windows; macOS path resolution is included but untested.