zotero-mcp 1.3.0

data/lib/zotero/mcp.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# 1. Standard library
+require "json"
+require "net/http"
+require "openssl"
+require "securerandom"
+require "uri"
+
+# 2. Third-party gems
+require "mcp"
+require "mcp/server/transports/stdio_transport"
+
+# 3. This library
+require_relative "mcp/version"
+require_relative "mcp/errors"
+require_relative "mcp/config"
+require_relative "mcp/helpers"
+require_relative "mcp/read_api"
+require_relative "mcp/write_api"
+require_relative "mcp/response_handling"
+require_relative "mcp/client"
+require_relative "mcp/formatting"
+require_relative "mcp/fulltext"
+require_relative "mcp/tools/search_items"
+require_relative "mcp/tools/get_item"
+require_relative "mcp/tools/list_collections"
+require_relative "mcp/tools/get_collection_items"
+require_relative "mcp/tools/list_tags"
+require_relative "mcp/tools/get_item_fulltext"
+require_relative "mcp/tools/generate_bibliography"
+require_relative "mcp/tools/get_item_template"
+require_relative "mcp/tools/create_item"
+require_relative "mcp/tools/create_note"
+require_relative "mcp/tools/update_item"
+require_relative "mcp/tools/delete_item"
+require_relative "mcp/tools/add_to_collection"
+require_relative "mcp/tools/create_collection"
+
+# Zotero MCP server: exposes the Zotero Web API v3 (and, read-only, the Zotero
+# desktop local API) as MCP tools for Claude Code and other MCP clients.
+#
+# Configuration comes from the environment:
+#   ZOTERO_API_KEY       key from https://www.zotero.org/settings/keys
+#   ZOTERO_LIBRARY_ID    numeric user/group id (auto-resolved from the key)
+#   ZOTERO_LIBRARY_TYPE  "user" (default) or "group"
+#   ZOTERO_LOCAL         "true" to read the local desktop app (read-only)
+module Zotero
+    module MCP
+        TOOLS = [
+            SearchItems, GetItem, ListCollections, GetCollectionItems,
+            ListTags, GetItemFulltext, GenerateBibliography, GetItemTemplate,
+            CreateItem, CreateNote, UpdateItem, DeleteItem, AddToCollection,
+            CreateCollection
+        ].freeze
+
+        def self.build_server
+            ::MCP::Server.new(name: "zotero-mcp", version: VERSION,
+                              tools: TOOLS)
+        end
+
+        # Serve on stdin/stdout until the client closes the stream.
+        def self.run
+            ::MCP::Server::Transports::StdioTransport.new(build_server).open
+        end
+    end
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: zotero-mcp
+version: !ruby/object:Gem::Version
+  version: 1.3.0
+platform: ruby
+authors:
+- Stephane D'Alu
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+description: |
+  A Model Context Protocol server that lets Claude Code and other MCP
+  clients search, read, cite and edit a Zotero library through the
+  Zotero Web API v3, or read it from the Zotero desktop app.
+email:
+- stephane.dalu@gmail.com
+executables:
+- zotero-mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- DESIGN.md
+- LICENSE
+- README.md
+- exe/zotero-mcp
+- lib/zotero/mcp.rb
+- lib/zotero/mcp/client.rb
+- lib/zotero/mcp/config.rb
+- lib/zotero/mcp/errors.rb
+- lib/zotero/mcp/formatting.rb
+- lib/zotero/mcp/fulltext.rb
+- lib/zotero/mcp/helpers.rb
+- lib/zotero/mcp/read_api.rb
+- lib/zotero/mcp/response_handling.rb
+- lib/zotero/mcp/tools/add_to_collection.rb
+- lib/zotero/mcp/tools/create_collection.rb
+- lib/zotero/mcp/tools/create_item.rb
+- lib/zotero/mcp/tools/create_note.rb
+- lib/zotero/mcp/tools/delete_item.rb
+- lib/zotero/mcp/tools/generate_bibliography.rb
+- lib/zotero/mcp/tools/get_collection_items.rb
+- lib/zotero/mcp/tools/get_item.rb
+- lib/zotero/mcp/tools/get_item_fulltext.rb
+- lib/zotero/mcp/tools/get_item_template.rb
+- lib/zotero/mcp/tools/list_collections.rb
+- lib/zotero/mcp/tools/list_tags.rb
+- lib/zotero/mcp/tools/search_items.rb
+- lib/zotero/mcp/tools/update_item.rb
+- lib/zotero/mcp/version.rb
+- lib/zotero/mcp/write_api.rb
+homepage: https://github.com/sdalu/zotero-mcp
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: MCP server for the Zotero Web API and the local Zotero app
+test_files: []