crossref-mcp-server 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. crossref_mcp_server-1.0.0/.env.example +2 -0
  2. crossref_mcp_server-1.0.0/.gitignore +9 -0
  3. crossref_mcp_server-1.0.0/LICENSE +21 -0
  4. crossref_mcp_server-1.0.0/PKG-INFO +101 -0
  5. crossref_mcp_server-1.0.0/README.md +83 -0
  6. crossref_mcp_server-1.0.0/pyproject.toml +29 -0
  7. crossref_mcp_server-1.0.0/requirements.txt +2 -0
  8. crossref_mcp_server-1.0.0/server.py +925 -0
  9. crossref_mcp_server-1.0.0/src/crossref_mcp_server/__init__.py +4 -0
  10. crossref_mcp_server-1.0.0/src/crossref_mcp_server/server.py +925 -0
crossref_mcp_server-1.0.0/.env.example ADDED
@@ -0,0 +1,2 @@
1
+ # Optional — provides better rate limits via CrossRef's "polite" pool
2
+ CROSSREF_MAILTO=your.email@example.com
crossref_mcp_server-1.0.0/.gitignore ADDED
@@ -0,0 +1,9 @@
1
+ venv/
2
+ __pycache__/
3
+ *.pyc
4
+ .env
5
+ .claude/
6
+ dist/
7
+ build/
8
+ *.egg-info/
9
+ src/*.egg-info/
crossref_mcp_server-1.0.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 SMABoundless
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
crossref_mcp_server-1.0.0/PKG-INFO ADDED
@@ -0,0 +1,101 @@
1
+ Metadata-Version: 2.4
2
+ Name: crossref-mcp-server
3
+ Version: 1.0.0
4
+ Summary: MCP server for the Crossref API — search and retrieve scholarly metadata
5
+ Project-URL: Repository, https://github.com/SMABoundless/crossref-mcp-server
6
+ Author: SMABoundless
7
+ License-Expression: MIT
8
+ License-File: LICENSE
9
+ Keywords: citations,crossref,doi,mcp,scholarly
10
+ Classifier: Development Status :: 4 - Beta
11
+ Classifier: Intended Audience :: Science/Research
12
+ Classifier: License :: OSI Approved :: MIT License
13
+ Classifier: Programming Language :: Python :: 3
14
+ Requires-Python: >=3.10
15
+ Requires-Dist: mcp[cli]>=1.0.0
16
+ Requires-Dist: requests>=2.28.0
17
+ Description-Content-Type: text/markdown
18
+
19
+ # CrossRef MCP Server
20
+
21
+ An MCP (Model Context Protocol) server for searching and retrieving scholarly metadata from the [CrossRef](https://www.crossref.org/) REST API — 150M+ records across all publishers and disciplines.
22
+
23
+ Built with [FastMCP](https://github.com/modelcontextprotocol/python-sdk). No API key required.
24
+
25
+ ## Tools
26
+
27
+ | Tool | Description |
28
+ |------|-------------|
29
+ | `crossref_search` | Search works by keyword with filtering by year, type, and sort options |
30
+ | `crossref_title_search` | Search specifically by title for more precise matching |
31
+ | `crossref_author_search` | Search for works by a specific author, optionally combined with keywords |
32
+ | `crossref_doi_lookup` | Retrieve full metadata for a work by DOI |
33
+ | `crossref_journal_search` | Search for journals by name |
34
+ | `crossref_journal_works` | Get works published in a specific journal by ISSN |
35
+ | `crossref_funder_search` | Search for funding organizations |
36
+ | `crossref_references` | Get the reference list cited by a specific work |
37
+ | `crossref_export_ris` | Export recent results as RIS (for Zotero, EndNote, etc.) |
38
+ | `crossref_export_bibtex` | Export recent results as BibTeX |
39
+
40
+ ## Setup
41
+
42
+ ### 1. Install
43
+
44
+ ```bash
45
+ cd crossref-mcp-server
46
+ python3 -m venv venv
47
+ source venv/bin/activate
48
+ pip install -r requirements.txt
49
+ ```
50
+
51
+ ### 2. Configure environment (optional)
52
+
53
+ CrossRef doesn't require an API key, but setting a mailto address gives you access to their faster "polite" API pool:
54
+
55
+ ```bash
56
+ cp .env.example .env
57
+ # Edit .env with your email address
58
+ ```
59
+
60
+ ### 3. Add to Claude Desktop
61
+
62
+ Add this to your `claude_desktop_config.json`:
63
+
64
+ ```json
65
+ {
66
+ "mcpServers": {
67
+ "crossref": {
68
+ "command": "/path/to/crossref-mcp-server/venv/bin/python",
69
+ "args": ["/path/to/crossref-mcp-server/server.py"],
70
+ "env": {
71
+ "CROSSREF_MAILTO": "your.email@example.com"
72
+ }
73
+ }
74
+ }
75
+ }
76
+ ```
77
+
78
+ Or if using Claude Code CLI:
79
+
80
+ ```bash
81
+ claude mcp add crossref \
82
+ /path/to/crossref-mcp-server/venv/bin/python \
83
+ /path/to/crossref-mcp-server/server.py \
84
+ -e CROSSREF_MAILTO=your.email@example.com
85
+ ```
86
+
87
+ ## Usage examples
88
+
89
+ Once connected, you can ask Claude things like:
90
+
91
+ - "Search CrossRef for recent papers on transformer architectures"
92
+ - "Find works by Jane Smith on educational psychology from 2020-2024"
93
+ - "Look up the metadata for DOI 10.1038/nature14539"
94
+ - "Search for journals about machine learning"
95
+ - "Get the reference list for this paper and export as RIS for Zotero"
96
+
97
+ ## License
98
+
99
+ MIT
100
+
101
+ <!-- mcp-name: io.github.SMABoundless/crossref -->
crossref_mcp_server-1.0.0/README.md ADDED
@@ -0,0 +1,83 @@
1
+ # CrossRef MCP Server
2
+
3
+ An MCP (Model Context Protocol) server for searching and retrieving scholarly metadata from the [CrossRef](https://www.crossref.org/) REST API — 150M+ records across all publishers and disciplines.
4
+
5
+ Built with [FastMCP](https://github.com/modelcontextprotocol/python-sdk). No API key required.
6
+
7
+ ## Tools
8
+
9
+ | Tool | Description |
10
+ |------|-------------|
11
+ | `crossref_search` | Search works by keyword with filtering by year, type, and sort options |
12
+ | `crossref_title_search` | Search specifically by title for more precise matching |
13
+ | `crossref_author_search` | Search for works by a specific author, optionally combined with keywords |
14
+ | `crossref_doi_lookup` | Retrieve full metadata for a work by DOI |
15
+ | `crossref_journal_search` | Search for journals by name |
16
+ | `crossref_journal_works` | Get works published in a specific journal by ISSN |
17
+ | `crossref_funder_search` | Search for funding organizations |
18
+ | `crossref_references` | Get the reference list cited by a specific work |
19
+ | `crossref_export_ris` | Export recent results as RIS (for Zotero, EndNote, etc.) |
20
+ | `crossref_export_bibtex` | Export recent results as BibTeX |
21
+
22
+ ## Setup
23
+
24
+ ### 1. Install
25
+
26
+ ```bash
27
+ cd crossref-mcp-server
28
+ python3 -m venv venv
29
+ source venv/bin/activate
30
+ pip install -r requirements.txt
31
+ ```
32
+
33
+ ### 2. Configure environment (optional)
34
+
35
+ CrossRef doesn't require an API key, but setting a mailto address gives you access to their faster "polite" API pool:
36
+
37
+ ```bash
38
+ cp .env.example .env
39
+ # Edit .env with your email address
40
+ ```
41
+
42
+ ### 3. Add to Claude Desktop
43
+
44
+ Add this to your `claude_desktop_config.json`:
45
+
46
+ ```json
47
+ {
48
+ "mcpServers": {
49
+ "crossref": {
50
+ "command": "/path/to/crossref-mcp-server/venv/bin/python",
51
+ "args": ["/path/to/crossref-mcp-server/server.py"],
52
+ "env": {
53
+ "CROSSREF_MAILTO": "your.email@example.com"
54
+ }
55
+ }
56
+ }
57
+ }
58
+ ```
59
+
60
+ Or if using Claude Code CLI:
61
+
62
+ ```bash
63
+ claude mcp add crossref \
64
+ /path/to/crossref-mcp-server/venv/bin/python \
65
+ /path/to/crossref-mcp-server/server.py \
66
+ -e CROSSREF_MAILTO=your.email@example.com
67
+ ```
68
+
69
+ ## Usage examples
70
+
71
+ Once connected, you can ask Claude things like:
72
+
73
+ - "Search CrossRef for recent papers on transformer architectures"
74
+ - "Find works by Jane Smith on educational psychology from 2020-2024"
75
+ - "Look up the metadata for DOI 10.1038/nature14539"
76
+ - "Search for journals about machine learning"
77
+ - "Get the reference list for this paper and export as RIS for Zotero"
78
+
79
+ ## License
80
+
81
+ MIT
82
+
83
+ <!-- mcp-name: io.github.SMABoundless/crossref -->
crossref_mcp_server-1.0.0/pyproject.toml ADDED
@@ -0,0 +1,29 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "crossref-mcp-server"
7
+ version = "1.0.0"
8
+ description = "MCP server for the Crossref API — search and retrieve scholarly metadata"
9
+ readme = "README.md"
10
+ license = "MIT"
11
+ requires-python = ">=3.10"
12
+ authors = [{ name = "SMABoundless" }]
13
+ keywords = ["mcp", "crossref", "scholarly", "doi", "citations"]
14
+ classifiers = [
15
+ "Development Status :: 4 - Beta",
16
+ "Intended Audience :: Science/Research",
17
+ "License :: OSI Approved :: MIT License",
18
+ "Programming Language :: Python :: 3",
19
+ ]
20
+ dependencies = [
21
+ "mcp[cli]>=1.0.0",
22
+ "requests>=2.28.0",
23
+ ]
24
+
25
+ [project.scripts]
26
+ crossref-mcp-server = "crossref_mcp_server:main"
27
+
28
+ [project.urls]
29
+ Repository = "https://github.com/SMABoundless/crossref-mcp-server"
crossref_mcp_server-1.0.0/requirements.txt ADDED
@@ -0,0 +1,2 @@
1
+ mcp
2
+ requests