pkm-mcp

# MCP Filestore Server A knowledge base file storage service based on Model Context Protocol (MCP). ## Features - Manage knowledge documents through MCP Tools (CRUD) - Support scanning and importing from local directory - Support importing/exporting from/to OAH (Open Agent Harness) sandbox - Attachments stored in MinIO, metadata stored in PostgreSQL ## Tools | Tool | Description | |------|-------------| | `add_to_knowledge_base` | Add knowledge document | | `scan_directory` | Scan local directory to import | | `import_from_oah` | Import from OAH sandbox | | `export_to_oah` | Export to OAH sandbox | | `list_knowledge_docs` | List knowledge documents | | `get_knowledge_doc` | Get document details | | `search_knowledge_files` | Search by keyword | | `search_and_download_files` | Search and download attachments | | `export_knowledge_doc_to_cwd` | Export Markdown to current directory | | `delete_knowledge_doc` | Delete document | | `list_attachments` | List attachments | | `get_attachment` | Download attachment (base64) | | `delete_attachment` | Delete attachment | ## Environment Variables Copy `.env.example` to `.env` and fill in: | Variable | Description | |----------|-------------| | `DATABASE_URL` | PostgreSQL connection string | | `MINIO_ENDPOINT` | MinIO endpoint | | `MINIO_PORT` | MinIO port | | `MINIO_ACCESS_KEY` | MinIO access key | | `MINIO_SECRET_KEY` | MinIO secret key | | `MINIO_BUCKET` | MinIO bucket name | | `OAH_BASE_URL` | OAH service URL (optional) | | `MCP_TRANSPORT` | `stdio` or `http` | | `MCP_PORT` | HTTP mode port | ## Installation and Running ```bash cd mcp-server npm install cp .env.example .env # Edit .env to fill in configurations npm run build npm start ``` ## Development Mode ```bash npx tsx src/index.ts ```