zotero-bridge 1.0.1

package/dist/tools.js

@@ -0,0 +1,425 @@
+/**
+ * ZoteroBridge - MCP Tool Definitions
+ *
+ * Defines all available MCP tools for Zotero operations
+ *
+ * @author Combjellyshen
+ */
+import { z } from 'zod';
+// ============================================
+// Collection/Directory Tools
+// ============================================
+export const listCollectionsSchema = z.object({
+    libraryID: z.number().optional().default(1).describe('Library ID (default: 1 for personal library)')
+});
+export const getCollectionSchema = z.object({
+    collectionID: z.number().optional().describe('Collection ID'),
+    name: z.string().optional().describe('Collection name'),
+    libraryID: z.number().optional().default(1).describe('Library ID')
+});
+export const createCollectionSchema = z.object({
+    name: z.string().describe('Name of the new collection'),
+    parentCollectionID: z.number().optional().describe('Parent collection ID (null for root)'),
+    libraryID: z.number().optional().default(1).describe('Library ID')
+});
+export const renameCollectionSchema = z.object({
+    collectionID: z.number().describe('Collection ID to rename'),
+    newName: z.string().describe('New name for the collection')
+});
+export const moveCollectionSchema = z.object({
+    collectionID: z.number().describe('Collection ID to move'),
+    newParentID: z.number().nullable().describe('New parent collection ID (null for root)')
+});
+export const deleteCollectionSchema = z.object({
+    collectionID: z.number().describe('Collection ID to delete')
+});
+export const getSubcollectionsSchema = z.object({
+    parentCollectionID: z.number().describe('Parent collection ID')
+});
+// ============================================
+// Tag Tools
+// ============================================
+export const listTagsSchema = z.object({});
+export const addTagSchema = z.object({
+    itemID: z.number().describe('Item ID to add tag to'),
+    tagName: z.string().describe('Tag name to add'),
+    type: z.number().optional().default(0).describe('Tag type (0=user, 1=automatic)')
+});
+export const removeTagSchema = z.object({
+    itemID: z.number().describe('Item ID to remove tag from'),
+    tagName: z.string().describe('Tag name to remove')
+});
+export const getItemTagsSchema = z.object({
+    itemID: z.number().describe('Item ID to get tags for')
+});
+export const createTagSchema = z.object({
+    name: z.string().describe('Tag name to create'),
+    type: z.number().optional().default(0).describe('Tag type')
+});
+// ============================================
+// Item Tools
+// ============================================
+export const searchItemsSchema = z.object({
+    query: z.string().describe('Search query for item titles'),
+    limit: z.number().optional().default(50).describe('Maximum number of results'),
+    libraryID: z.number().optional().default(1).describe('Library ID')
+});
+export const getItemDetailsSchema = z.object({
+    itemID: z.number().optional().describe('Item ID'),
+    itemKey: z.string().optional().describe('Item key')
+});
+export const addItemToCollectionSchema = z.object({
+    itemID: z.number().describe('Item ID to add'),
+    collectionID: z.number().describe('Collection ID to add item to')
+});
+export const removeItemFromCollectionSchema = z.object({
+    itemID: z.number().describe('Item ID to remove'),
+    collectionID: z.number().describe('Collection ID to remove item from')
+});
+export const getCollectionItemsSchema = z.object({
+    collectionID: z.number().describe('Collection ID to get items from')
+});
+// ============================================
+// Abstract/Note Tools
+// ============================================
+export const getItemAbstractSchema = z.object({
+    itemID: z.number().describe('Item ID to get abstract for')
+});
+export const setItemAbstractSchema = z.object({
+    itemID: z.number().describe('Item ID to set abstract for'),
+    abstract: z.string().describe('Abstract text')
+});
+export const getItemNotesSchema = z.object({
+    itemID: z.number().describe('Item ID to get notes for')
+});
+export const addItemNoteSchema = z.object({
+    itemID: z.number().describe('Parent item ID'),
+    content: z.string().describe('Note content (can include HTML)'),
+    title: z.string().optional().default('').describe('Note title')
+});
+// ============================================
+// PDF Tools
+// ============================================
+export const extractPDFTextSchema = z.object({
+    attachmentItemID: z.number().describe('Attachment item ID of the PDF')
+});
+export const getPDFSummarySchema = z.object({
+    attachmentItemID: z.number().describe('Attachment item ID of the PDF')
+});
+export const getItemPDFsSchema = z.object({
+    parentItemID: z.number().describe('Parent item ID to get PDFs from')
+});
+export const searchPDFSchema = z.object({
+    attachmentItemID: z.number().describe('Attachment item ID of the PDF'),
+    query: z.string().describe('Search query'),
+    caseSensitive: z.boolean().optional().default(false).describe('Case sensitive search')
+});
+export const generateAbstractFromPDFSchema = z.object({
+    attachmentItemID: z.number().describe('Attachment item ID of the PDF'),
+    maxLength: z.number().optional().default(1000).describe('Maximum length of generated abstract'),
+    saveToItem: z.boolean().optional().default(false).describe('Save generated abstract to parent item')
+});
+// ============================================
+// Identifier Tools (DOI/ISBN)
+// ============================================
+export const findByDOISchema = z.object({
+    doi: z.string().describe('DOI to search for (with or without doi.org prefix)')
+});
+export const findByISBNSchema = z.object({
+    isbn: z.string().describe('ISBN to search for (with or without hyphens)')
+});
+export const findByIdentifierSchema = z.object({
+    identifier: z.string().describe('Identifier value (DOI, ISBN, PMID, etc.)'),
+    type: z.string().optional().describe('Identifier type: doi, isbn, pmid, arxiv, url')
+});
+// ============================================
+// Annotation Tools
+// ============================================
+export const getItemAnnotationsSchema = z.object({
+    itemID: z.number().describe('Parent item ID to get annotations from')
+});
+export const getAttachmentAnnotationsSchema = z.object({
+    attachmentID: z.number().describe('Attachment item ID to get annotations from')
+});
+export const getAnnotationsByTypeSchema = z.object({
+    itemID: z.number().describe('Parent item ID'),
+    types: z.array(z.string()).describe('Annotation types: highlight, note, image, ink, underline')
+});
+export const getAnnotationsByColorSchema = z.object({
+    itemID: z.number().describe('Parent item ID'),
+    colors: z.array(z.string()).describe('Annotation colors (hex codes like #ffff00)')
+});
+export const searchAnnotationsSchema = z.object({
+    query: z.string().describe('Search query for annotation text/comments'),
+    itemID: z.number().optional().describe('Limit search to specific item')
+});
+// ============================================
+// Fulltext Search Tools
+// ============================================
+export const searchFulltextSchema = z.object({
+    query: z.string().describe('Search query for fulltext content'),
+    libraryID: z.number().optional().default(1).describe('Library ID')
+});
+export const getFulltextContentSchema = z.object({
+    attachmentID: z.number().describe('Attachment item ID to get fulltext from')
+});
+export const searchFulltextWithContextSchema = z.object({
+    query: z.string().describe('Search query'),
+    contextLength: z.number().optional().default(100).describe('Characters of context around matches'),
+    libraryID: z.number().optional().default(1).describe('Library ID')
+});
+// ============================================
+// Similar Items Tools
+// ============================================
+export const getRelatedItemsSchema = z.object({
+    itemID: z.number().describe('Item ID to get related items for')
+});
+export const findSimilarByTagsSchema = z.object({
+    itemID: z.number().describe('Item ID to find similar items for'),
+    minSharedTags: z.number().optional().default(2).describe('Minimum number of shared tags')
+});
+export const findSimilarByCreatorsSchema = z.object({
+    itemID: z.number().describe('Item ID to find similar items for')
+});
+export const findSimilarByCollectionSchema = z.object({
+    itemID: z.number().describe('Item ID to find similar items for')
+});
+// ============================================
+// Utility Tools
+// ============================================
+export const getDatabaseInfoSchema = z.object({});
+export const rawQuerySchema = z.object({
+    sql: z.string().describe('SQL query to execute (SELECT only)'),
+    params: z.array(z.any()).optional().default([]).describe('Query parameters')
+});
+// ============================================
+// Tool Definitions
+// ============================================
+export const toolDefinitions = [
+    // Collection Tools
+    {
+        name: 'list_collections',
+        description: 'List all collections (folders) in the Zotero library',
+        inputSchema: listCollectionsSchema
+    },
+    {
+        name: 'get_collection',
+        description: 'Get a collection by ID or name',
+        inputSchema: getCollectionSchema
+    },
+    {
+        name: 'create_collection',
+        description: 'Create a new collection (folder)',
+        inputSchema: createCollectionSchema
+    },
+    {
+        name: 'rename_collection',
+        description: 'Rename an existing collection',
+        inputSchema: renameCollectionSchema
+    },
+    {
+        name: 'move_collection',
+        description: 'Move a collection to a new parent (or root)',
+        inputSchema: moveCollectionSchema
+    },
+    {
+        name: 'delete_collection',
+        description: 'Delete a collection',
+        inputSchema: deleteCollectionSchema
+    },
+    {
+        name: 'get_subcollections',
+        description: 'Get all subcollections of a collection',
+        inputSchema: getSubcollectionsSchema
+    },
+    // Tag Tools
+    {
+        name: 'list_tags',
+        description: 'List all tags in the library',
+        inputSchema: listTagsSchema
+    },
+    {
+        name: 'add_tag',
+        description: 'Add a tag to an item',
+        inputSchema: addTagSchema
+    },
+    {
+        name: 'remove_tag',
+        description: 'Remove a tag from an item',
+        inputSchema: removeTagSchema
+    },
+    {
+        name: 'get_item_tags',
+        description: 'Get all tags for an item',
+        inputSchema: getItemTagsSchema
+    },
+    {
+        name: 'create_tag',
+        description: 'Create a new tag',
+        inputSchema: createTagSchema
+    },
+    // Item Tools
+    {
+        name: 'search_items',
+        description: 'Search items by title',
+        inputSchema: searchItemsSchema
+    },
+    {
+        name: 'get_item_details',
+        description: 'Get detailed information about an item',
+        inputSchema: getItemDetailsSchema
+    },
+    {
+        name: 'add_item_to_collection',
+        description: 'Add an item to a collection',
+        inputSchema: addItemToCollectionSchema
+    },
+    {
+        name: 'remove_item_from_collection',
+        description: 'Remove an item from a collection',
+        inputSchema: removeItemFromCollectionSchema
+    },
+    {
+        name: 'get_collection_items',
+        description: 'Get all items in a collection',
+        inputSchema: getCollectionItemsSchema
+    },
+    // Abstract/Note Tools
+    {
+        name: 'get_item_abstract',
+        description: 'Get the abstract of an item',
+        inputSchema: getItemAbstractSchema
+    },
+    {
+        name: 'set_item_abstract',
+        description: 'Set or update the abstract of an item',
+        inputSchema: setItemAbstractSchema
+    },
+    {
+        name: 'get_item_notes',
+        description: 'Get all notes attached to an item',
+        inputSchema: getItemNotesSchema
+    },
+    {
+        name: 'add_item_note',
+        description: 'Add a note to an item',
+        inputSchema: addItemNoteSchema
+    },
+    // PDF Tools
+    {
+        name: 'extract_pdf_text',
+        description: 'Extract full text from a PDF attachment',
+        inputSchema: extractPDFTextSchema
+    },
+    {
+        name: 'get_pdf_summary',
+        description: 'Get summary information about a PDF',
+        inputSchema: getPDFSummarySchema
+    },
+    {
+        name: 'get_item_pdfs',
+        description: 'Get all PDF attachments for an item',
+        inputSchema: getItemPDFsSchema
+    },
+    {
+        name: 'search_pdf',
+        description: 'Search within a PDF for specific text',
+        inputSchema: searchPDFSchema
+    },
+    {
+        name: 'generate_abstract_from_pdf',
+        description: 'Extract and generate an abstract from PDF content',
+        inputSchema: generateAbstractFromPDFSchema
+    },
+    // Identifier Tools
+    {
+        name: 'find_by_doi',
+        description: 'Find an item by its DOI',
+        inputSchema: findByDOISchema
+    },
+    {
+        name: 'find_by_isbn',
+        description: 'Find an item by its ISBN',
+        inputSchema: findByISBNSchema
+    },
+    {
+        name: 'find_by_identifier',
+        description: 'Find an item by any identifier (DOI, ISBN, PMID, arXiv, URL)',
+        inputSchema: findByIdentifierSchema
+    },
+    // Annotation Tools
+    {
+        name: 'get_item_annotations',
+        description: 'Get all annotations (highlights, notes, etc.) from an item\'s PDF attachments',
+        inputSchema: getItemAnnotationsSchema
+    },
+    {
+        name: 'get_attachment_annotations',
+        description: 'Get annotations from a specific PDF attachment',
+        inputSchema: getAttachmentAnnotationsSchema
+    },
+    {
+        name: 'get_annotations_by_type',
+        description: 'Get annotations filtered by type (highlight, note, image, ink, underline)',
+        inputSchema: getAnnotationsByTypeSchema
+    },
+    {
+        name: 'get_annotations_by_color',
+        description: 'Get annotations filtered by color',
+        inputSchema: getAnnotationsByColorSchema
+    },
+    {
+        name: 'search_annotations',
+        description: 'Search annotations by text content',
+        inputSchema: searchAnnotationsSchema
+    },
+    // Fulltext Search Tools
+    {
+        name: 'search_fulltext',
+        description: 'Search in Zotero\'s fulltext index (searches indexed PDF content)',
+        inputSchema: searchFulltextSchema
+    },
+    {
+        name: 'get_fulltext_content',
+        description: 'Get the indexed fulltext content of an attachment',
+        inputSchema: getFulltextContentSchema
+    },
+    {
+        name: 'search_fulltext_with_context',
+        description: 'Search fulltext and return matching context snippets',
+        inputSchema: searchFulltextWithContextSchema
+    },
+    // Similar Items Tools
+    {
+        name: 'get_related_items',
+        description: 'Get manually linked related items',
+        inputSchema: getRelatedItemsSchema
+    },
+    {
+        name: 'find_similar_by_tags',
+        description: 'Find items with similar tags',
+        inputSchema: findSimilarByTagsSchema
+    },
+    {
+        name: 'find_similar_by_creators',
+        description: 'Find items by the same authors/creators',
+        inputSchema: findSimilarByCreatorsSchema
+    },
+    {
+        name: 'find_similar_by_collection',
+        description: 'Find items in the same collections',
+        inputSchema: findSimilarByCollectionSchema
+    },
+    // Utility Tools
+    {
+        name: 'get_database_info',
+        description: 'Get information about the Zotero database',
+        inputSchema: getDatabaseInfoSchema
+    },
+    {
+        name: 'raw_query',
+        description: 'Execute a raw SQL SELECT query (read-only)',
+        inputSchema: rawQuerySchema
+    }
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "zotero-bridge",
+  "version": "1.0.1",
+  "mcpName": "io.github.combjellyshen/zotero-bridge",
+  "description": "ZoteroBridge - MCP Server for Zotero SQLite Database Integration",
+  "author": "Combjellyshen",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "zotero-bridge": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "node test/run-test.mjs",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rimraf dist"
+  },
+  "keywords": [
+    "zotero",
+    "mcp",
+    "model-context-protocol",
+    "sqlite",
+    "reference-management",
+    "pdf",
+    "research"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Combjellyshen/ZoteroBridge"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "sql.js": "^1.10.0",
+    "pdf-parse": "^1.1.1",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/sql.js": "^1.4.9",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.0"
+  }
+}

package/server.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.combjellyshen/zotero-bridge",
+  "description": "ZoteroBridge - MCP Server for Zotero SQLite Database Integration. Direct access to Zotero's SQLite database for collection management, tagging, PDF reading, and more.",
+  "repository": {
+    "url": "https://github.com/Combjellyshen/ZoteroBridge",
+    "source": "github"
+  },
+  "version": "1.0.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "zotero-bridge",
+      "version": "1.0.1",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}