@cyanheads/wikidata-mcp-server 0.1.1

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 (61) hide show
  1. package/CLAUDE.md +401 -0
  2. package/Dockerfile +98 -0
  3. package/LICENSE +201 -0
  4. package/README.md +293 -0
  5. package/changelog/0.1.x/0.1.0.md +20 -0
  6. package/changelog/0.1.x/0.1.1.md +20 -0
  7. package/changelog/template.md +119 -0
  8. package/dist/config/server-config.d.ts +11 -0
  9. package/dist/config/server-config.d.ts.map +1 -0
  10. package/dist/config/server-config.js +31 -0
  11. package/dist/config/server-config.js.map +1 -0
  12. package/dist/index.d.ts +7 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +34 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/mcp-server/resources/definitions/entity.resource.d.ts +11 -0
  17. package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -0
  18. package/dist/mcp-server/resources/definitions/entity.resource.js +127 -0
  19. package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -0
  20. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +38 -0
  21. package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
  22. package/dist/mcp-server/tools/definitions/get-entity.tool.js +215 -0
  23. package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
  24. package/dist/mcp-server/tools/definitions/get-labels.tool.d.ts +24 -0
  25. package/dist/mcp-server/tools/definitions/get-labels.tool.d.ts.map +1 -0
  26. package/dist/mcp-server/tools/definitions/get-labels.tool.js +93 -0
  27. package/dist/mcp-server/tools/definitions/get-labels.tool.js.map +1 -0
  28. package/dist/mcp-server/tools/definitions/get-sitelinks.tool.d.ts +31 -0
  29. package/dist/mcp-server/tools/definitions/get-sitelinks.tool.d.ts.map +1 -0
  30. package/dist/mcp-server/tools/definitions/get-sitelinks.tool.js +128 -0
  31. package/dist/mcp-server/tools/definitions/get-sitelinks.tool.js.map +1 -0
  32. package/dist/mcp-server/tools/definitions/get-statements.tool.d.ts +29 -0
  33. package/dist/mcp-server/tools/definitions/get-statements.tool.d.ts.map +1 -0
  34. package/dist/mcp-server/tools/definitions/get-statements.tool.js +185 -0
  35. package/dist/mcp-server/tools/definitions/get-statements.tool.js.map +1 -0
  36. package/dist/mcp-server/tools/definitions/resolve-external-id.tool.d.ts +30 -0
  37. package/dist/mcp-server/tools/definitions/resolve-external-id.tool.d.ts.map +1 -0
  38. package/dist/mcp-server/tools/definitions/resolve-external-id.tool.js +193 -0
  39. package/dist/mcp-server/tools/definitions/resolve-external-id.tool.js.map +1 -0
  40. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +36 -0
  41. package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -0
  42. package/dist/mcp-server/tools/definitions/search-entities.tool.js +129 -0
  43. package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -0
  44. package/dist/mcp-server/tools/definitions/sparql-query.tool.d.ts +34 -0
  45. package/dist/mcp-server/tools/definitions/sparql-query.tool.d.ts.map +1 -0
  46. package/dist/mcp-server/tools/definitions/sparql-query.tool.js +151 -0
  47. package/dist/mcp-server/tools/definitions/sparql-query.tool.js.map +1 -0
  48. package/dist/services/wikidata/types.d.ts +164 -0
  49. package/dist/services/wikidata/types.d.ts.map +1 -0
  50. package/dist/services/wikidata/types.js +6 -0
  51. package/dist/services/wikidata/types.js.map +1 -0
  52. package/dist/services/wikidata/wikidata-rest-service.d.ts +48 -0
  53. package/dist/services/wikidata/wikidata-rest-service.d.ts.map +1 -0
  54. package/dist/services/wikidata/wikidata-rest-service.js +293 -0
  55. package/dist/services/wikidata/wikidata-rest-service.js.map +1 -0
  56. package/dist/services/wikidata/wikidata-sparql-service.d.ts +23 -0
  57. package/dist/services/wikidata/wikidata-sparql-service.d.ts.map +1 -0
  58. package/dist/services/wikidata/wikidata-sparql-service.js +163 -0
  59. package/dist/services/wikidata/wikidata-sparql-service.js.map +1 -0
  60. package/package.json +82 -0
  61. package/server.json +141 -0
package/server.json ADDED
@@ -0,0 +1,141 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "cyanheads/wikidata-mcp-server",
4
+ "description": "MCP server for Wikidata — entity search and fetch, SPARQL queries, and external ID lookup.",
5
+ "repository": {
6
+ "url": "https://github.com/cyanheads/wikidata-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "version": "0.1.1",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "registryBaseUrl": "https://registry.npmjs.org",
14
+ "identifier": "@cyanheads/wikidata-mcp-server",
15
+ "runtimeHint": "node",
16
+ "version": "0.1.1",
17
+ "packageArguments": [
18
+ {
19
+ "type": "positional",
20
+ "value": "run"
21
+ },
22
+ {
23
+ "type": "positional",
24
+ "value": "start:stdio"
25
+ }
26
+ ],
27
+ "environmentVariables": [
28
+ {
29
+ "name": "WIKIDATA_USER_AGENT",
30
+ "description": "User-Agent string for Wikimedia requests. Wikimedia policy requires a descriptive value.",
31
+ "format": "string",
32
+ "isRequired": false,
33
+ "default": "wikidata-mcp-server/0.1 (https://github.com/cyanheads/wikidata-mcp-server)"
34
+ },
35
+ {
36
+ "name": "WIKIDATA_SPARQL_TIMEOUT_MS",
37
+ "description": "Max time to wait for a SPARQL response in milliseconds.",
38
+ "format": "string",
39
+ "isRequired": false,
40
+ "default": "55000"
41
+ },
42
+ {
43
+ "name": "WIKIDATA_REST_TIMEOUT_MS",
44
+ "description": "Max time to wait for REST API responses in milliseconds.",
45
+ "format": "string",
46
+ "isRequired": false,
47
+ "default": "10000"
48
+ },
49
+ {
50
+ "name": "MCP_LOG_LEVEL",
51
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
52
+ "format": "string",
53
+ "isRequired": false,
54
+ "default": "info"
55
+ }
56
+ ],
57
+ "transport": {
58
+ "type": "stdio"
59
+ }
60
+ },
61
+ {
62
+ "registryType": "npm",
63
+ "registryBaseUrl": "https://registry.npmjs.org",
64
+ "identifier": "@cyanheads/wikidata-mcp-server",
65
+ "runtimeHint": "node",
66
+ "version": "0.1.1",
67
+ "packageArguments": [
68
+ {
69
+ "type": "positional",
70
+ "value": "run"
71
+ },
72
+ {
73
+ "type": "positional",
74
+ "value": "start:http"
75
+ }
76
+ ],
77
+ "environmentVariables": [
78
+ {
79
+ "name": "MCP_HTTP_HOST",
80
+ "description": "The hostname for the HTTP server.",
81
+ "format": "string",
82
+ "isRequired": false,
83
+ "default": "127.0.0.1"
84
+ },
85
+ {
86
+ "name": "MCP_HTTP_PORT",
87
+ "description": "The port to run the HTTP server on.",
88
+ "format": "string",
89
+ "isRequired": false,
90
+ "default": "3010"
91
+ },
92
+ {
93
+ "name": "MCP_HTTP_ENDPOINT_PATH",
94
+ "description": "The endpoint path for the MCP server.",
95
+ "format": "string",
96
+ "isRequired": false,
97
+ "default": "/mcp"
98
+ },
99
+ {
100
+ "name": "MCP_AUTH_MODE",
101
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
102
+ "format": "string",
103
+ "isRequired": false,
104
+ "default": "none"
105
+ },
106
+ {
107
+ "name": "WIKIDATA_USER_AGENT",
108
+ "description": "User-Agent string for Wikimedia requests. Wikimedia policy requires a descriptive value.",
109
+ "format": "string",
110
+ "isRequired": false,
111
+ "default": "wikidata-mcp-server/0.1 (https://github.com/cyanheads/wikidata-mcp-server)"
112
+ },
113
+ {
114
+ "name": "WIKIDATA_SPARQL_TIMEOUT_MS",
115
+ "description": "Max time to wait for a SPARQL response in milliseconds.",
116
+ "format": "string",
117
+ "isRequired": false,
118
+ "default": "55000"
119
+ },
120
+ {
121
+ "name": "WIKIDATA_REST_TIMEOUT_MS",
122
+ "description": "Max time to wait for REST API responses in milliseconds.",
123
+ "format": "string",
124
+ "isRequired": false,
125
+ "default": "10000"
126
+ },
127
+ {
128
+ "name": "MCP_LOG_LEVEL",
129
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
130
+ "format": "string",
131
+ "isRequired": false,
132
+ "default": "info"
133
+ }
134
+ ],
135
+ "transport": {
136
+ "type": "streamable-http",
137
+ "url": "http://localhost:3010/mcp"
138
+ }
139
+ }
140
+ ]
141
+ }