Skip to content

Commit 2354abe

Browse files
committed
Rename Zotero tools to generic bibliography tools
1 parent d505bd6 commit 2354abe

File tree

6 files changed

+35
-410
lines changed

6 files changed

+35
-410
lines changed

CLAUDE.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,8 +68,8 @@ The MCP server currently provides the following tools:
6868
21. **`duplicate_record`** - Duplicate records to any database (creates independent copies)
6969
22. **`convert_record`** - Convert records to different formats (plain text, rich text, markdown, HTML, PDF, etc.)
7070
23. **`update_record_content`** - Update the content of existing records while preserving UUID and metadata
71-
24. **`get_zotero_metadata`** - Look up Zotero attachment metadata for a DEVONthink record or Finder path, returning handy top-level `citationKey`, `zoteroId`, attachment listings, and a short `metadataSummary`
72-
25. **`find_records_by_citation_key`** - Resolve a Zotero citation key to its attachment metadata and any DEVONthink records whose Finder paths match those attachments
71+
24. **`get_bib_metadata`** - Look up bibliography metadata for a DEVONthink record or Finder path, returning top-level `citationKey`, `zoteroId`, attachment listings, and a short `metadataSummary`
72+
25. **`get_records_by_citekey`** - Resolve a citation key to its attachment metadata and any DEVONthink records whose Finder paths match those attachments
7373

7474
## Adding New Tools
7575

README.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
Modified based on [dvcrn/mcp-server-devonthink](https://github.com/dvcrn/mcp-server-devonthink)
22

3-
# DEVONthink Zotero MCP Server
3+
# DEVONthink MCP Server
44

5-
This MCP server provides access to DEVONthink functionality via the Model Context Protocol (MCP). It enables listing, searching, creating, modifying, and managing records and databases in DEVONthink Pro on macOS. Additionally, it includes tools to resolve Zotero metadata for DEVONthink attachments based on exported Zotero data.
5+
This MCP server provides access to DEVONthink functionality via the Model Context Protocol (MCP). It enables listing, searching, creating, modifying, and managing records and databases in DEVONthink Pro on macOS. Additionally, it includes tools to resolve bibliography metadata for DEVONthink attachments based on exported bibliography data.
66

77
![screenshot](./screenshot.png)
88

@@ -14,8 +14,8 @@ This MCP server provides access to DEVONthink functionality via the Model Contex
1414
- Retrieve and modify record content, properties, and tags
1515
- Create records from URLs in multiple formats
1616
- List open databases and group contents
17-
- Resolve Zotero metadata for DEVONthink attachments via Zotero exports
18-
- Locate DEVONthink records directly from Zotero citation keys or attachment metadata
17+
- Resolve bibliography metadata for DEVONthink attachments via bibliography exports
18+
- Locate DEVONthink records directly from citation keys or attachment metadata
1919
- All tools are type-safe and validated with Zod schemas
2020

2121
## Tools
@@ -104,15 +104,15 @@ This MCP server provides access to DEVONthink functionality via the Model Contex
104104
- Input: primary record UUID, optional second record UUID, database name, and comparison type
105105
- Returns: Either similar records (single mode) or detailed comparison analysis (two-record mode)
106106

107-
17. `get_zotero_metadata`
108-
- Resolves Zotero metadata for a DEVONthink record or Finder path
107+
17. `get_bib_metadata`
108+
- Resolves bibliography metadata for a DEVONthink record or Finder path
109109
- Input: Finder path, record UUID, DEVONthink ID + database, or DEVONthink location path (optional `zoteroJsonPath` / `zoteroBibPath` override export locations)
110-
- Returns: The matched Zotero item with top-level `citationKey`, `zoteroId`, attachment list, and a short summary string for LLM prompts
110+
- Returns: The matched bibliography item with top-level `citationKey`, `zoteroId`, attachment list, and a short summary string for LLM prompts
111111

112-
18. `find_records_by_citation_key`
113-
- Resolves a Zotero citation key to its attachment metadata and matching DEVONthink records
114-
- Input: `citationKey` along with optional overrides for Zotero JSON/BibTeX export paths
115-
- Returns: Zotero metadata (JSON or BibTeX) plus any DEVONthink records whose Finder paths match the attachment entries
112+
18. `get_records_by_citekey`
113+
- Resolves a citation key to its attachment metadata and matching DEVONthink records
114+
- Input: `citationKey` along with optional overrides for JSON/BibTeX export paths
115+
- Returns: Bibliography metadata (JSON or BibTeX) plus any DEVONthink records whose Finder paths match the attachment entries
116116

117117
### Example: Search Tool
118118

@@ -143,7 +143,7 @@ Add to your Claude configuration:
143143
"mcpServers": {
144144
"devonthink": {
145145
"command": "npx",
146-
"args": ["-y", "github:TomBener/devonthink-zotero-mcp"],
146+
"args": ["-y", "github:TomBener/devonthink-mcp"],
147147
"env": {
148148
"ZOTERO_BIBLIOGRAPHY_JSON": "/path/to/bibliography.json"
149149
// "ZOTERO_BIBLIOGRAPHY_BIB": "/path/to/bibliography.bib"
@@ -163,11 +163,11 @@ Add to your Claude configuration:
163163

164164
See [CLAUDE.md](./CLAUDE.md) for full documentation, tool development guidelines, and API reference.
165165

166-
## Zotero Metadata Lookup
166+
## Bibliography Metadata Lookup
167167

168-
Zotero attachments stored in DEVONthink can be matched to exported Zotero metadata. The MCP server inspects both JSON and BibTeX exports and prefers JSON when both are present.
168+
Bibliography attachments stored in DEVONthink can be matched to exported bibliography metadata. The MCP server inspects both JSON and BibTeX exports and prefers JSON when both are present.
169169

170-
1. Export your Zotero library (or a subset) to `bibliography.json` and/or `bibliography.bib`.
170+
1. Export your bibliography library (or a subset) to `bibliography.json` and/or `bibliography.bib`.
171171
2. Point the server at the exports via environment variables before launching it (using Claude's MCP configuration or your shell):
172172

173173
```bash
@@ -178,7 +178,7 @@ Zotero attachments stored in DEVONthink can be matched to exported Zotero metada
178178
- Supplying only one file is fine—the server detects whether you provided a `.json` or `.bib` path and uses it automatically.
179179
- If no metadata file is configured, the tool returns an informative error so you can correct the setup.
180180

181-
3. Call the `get_zotero_metadata` tool with a Finder path or any supported DEVONthink identifier. The tool returns the matched Zotero entry (including citation key, fields, and the property that matched), exposes `citationKey` / `zoteroId` at the top level, and provides a brief `metadataSummary` string for LLM prompts. If no match is found, the response lists the files that were checked.
181+
3. Call the `get_bib_metadata` tool with a Finder path or any supported DEVONthink identifier. The tool returns the matched bibliography entry (including citation key, fields, and the property that matched), exposes `citationKey` / `zoteroId` at the top level, and provides a brief `metadataSummary` string for LLM prompts. If no match is found, the response lists the files that were checked.
182182

183183
Example invocation:
184184

0 commit comments

Comments
 (0)