Earth616 Vocabulary Service
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Earth616 Vocabulary Service Show me the ontology information"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Earth616 MCP Vocabulary Service
A Model Context Protocol (MCP) server for accessing the Earth616 Defense Supply Chain and Documentation Ontology (DSCDO).
Quick Start
Option 1: Local Development
Build the service:
npm install npm run buildTest the service locally:
# Test that it starts up node dist/index.js # Should output: "Earth616 MCP Vocabulary Server running on stdio" # Press Ctrl+C to exit
Option 2: Docker Development (Recommended)
Start the full stack:
npm run docker:upThis starts:
Nginx server on port 8080 (serving example ontology files)
MCP vocabulary service (connected to nginx)
Test the stack:
# Test ontology server curl http://localhost:8080/health # View example files curl http://localhost:8080/example/View logs:
npm run docker:logsStop the stack:
npm run docker:downConnect to Claude Desktop:
Copy the configuration from
claude_desktop_config.jsonto your Claude Desktop configuration file:Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Or merge with existing config:
{ "mcpServers": { "earth616-vocab": { "command": "node", "args": ["/full/path/to/earth616_mcp_vocab_service/dist/index.js"], "env": { "NODE_ENV": "development" } } } }Test in Claude Desktop:
After restarting Claude Desktop, you should be able to use these tools:
hello_vocab- Simple test toolget_ontology_info- Basic ontology informationtest_ontology_server- Test connectivity to the ontology file serverlist_example_files- List available example files
Related MCP server: BioOntology MCP Server
Current Status
This is a minimal MCP server with Docker integration. Available tools:
hello_vocab: Echo back a message (testing connectivity)
get_ontology_info: Get basic information about the Earth616 ontology
test_ontology_server: Test connectivity to the ontology file server
list_example_files: List available example ontology files
The Docker setup provides:
nginx: Serves ontology files with proper content types
MCP service: Connects to nginx and provides vocabulary access
Health checks:
/healthendpoint for service monitoring
Next Steps
Following the iterative approach outlined in VOCAB_SERVICE_PLAN.md, we'll gradually add:
File-based vocabulary term lookup
URI resolution capabilities
W3C PROF Profile navigation
Complete vocabulary dataset access
Cross-layer navigation tools
Development
Local Development
npm run dev- Watch mode for developmentnpm run build- Build TypeScriptnpm start- Run the built server
Docker Development
npm run docker:build- Build Docker imagenpm run docker:up- Start full stack (detached)npm run docker:down- Stop full stacknpm run docker:logs- View MCP service logsnpm run docker:test- Quick health check test
Development Workflow
Make changes to
src/index.tsnpm run docker:upto test with full stackUse Claude Desktop tools to test functionality
npm run docker:logsto debug issuesnpm run docker:downwhen done
The server runs on stdio and communicates with Claude Desktop via the MCP protocol. The Docker setup simulates the full production environment locally.
Available Tools
18 toolsdiscover_shapesB
Discover and list all available SHACL shapes with their URIs and descriptions
Inputs: format, version.
explore_vocabularyB
Get a comprehensive overview of all available Earth616 vocabulary resources, files, and capabilities
Inputs: no named parameters.
get_layer_infoA
Get information about available CogitareLink layers and their URI mappings
Inputs: layer.
get_ontology_infoB
Get basic information about the Earth616 ontology
Inputs: no named parameters.
get_shape_contentC
Get the full content of a specific SHACL shape file with proper dereferencing
Inputs: shape_name (required), format, version.
hello_vocabB
Simple hello world tool for Earth616 vocabulary service
Inputs: message (required).
list_all_filesB
List all available files across ontologies, contexts, shapes, and examples with descriptions
Inputs: version.
list_context_releasesA
List available JSON-LD context release versions
Inputs: no named parameters.
list_example_filesB
List available example ontology files
Inputs: no named parameters.
list_ontology_releasesB
List available ontology release versions
Inputs: no named parameters.
list_shape_releasesA
List available SHACL shape release versions
Inputs: no named parameters.
read_context_fileB
Read a specific JSON-LD context file from a release
Inputs: filename (required), version.
read_example_fileB
Read the contents of a specific example file
Inputs: filename (required).
read_ontology_fileB
Read a specific ontology file from a release
Inputs: filename (required), version.
read_shape_fileA
Read a specific SHACL shape file from a release
Inputs: filename (required), version.
resolve_termB
Resolve a vocabulary term to its definition, context, and related information
Inputs: term (required), format, include_hierarchy.
resolve_uriB
Resolve a persistent URI to its deployment URL with content negotiation
Inputs: uri (required), accept.
test_ontology_serverA
Test connectivity to the ontology file server
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools have clear distinct purposes, but list_all_files overlaps with specific list functions and some read functions are similar across file types, causing minor potential confusion.
Tool names follow a consistent verb_noun snake_case pattern for the most part, though 'hello_vocab' uses a non-verb greeting, slightly breaking the pattern.
18 tools is reasonable for a vocabulary service covering multiple file types and operations, though slightly on the higher side; each tool seems justified.
The tool set covers browsing and reading of ontologies, contexts, shapes, and URIs, but lacks a tool to list all vocabulary terms, leaving a minor gap in discoverability.
Maintenance
Related MCP Connectors
Hosted MCP server for finding authoritative primary data sources and official portals.
MCP server for The Chancery Lane Project's climate-aligned contract clause knowledge graph.
Guarded MCP server for agent-readable business truth, provenance, readiness, and discovery.
An MCP server for deep research or task groups
Related MCP Servers
- AlicenseBqualityFmaintenanceMCP Server for the Marvel Developer API, enabling interaction with characters and comics data.730 npm14MIT
- AlicenseBqualityDmaintenanceA production-ready Model Context Protocol (MCP) server that provides comprehensive access to the BioOntology API for searching, annotating, and exploring over 1,200 biological ontologies.1010MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that provides semantic search, graph query, and keyword search tools for interacting with DocSmith's knowledge graph and documentation.1MIT
- AlicenseNot gradedqualityDmaintenanceMCP servers for querying Brick and 223P ontologies, enabling abbreviation expansion, term/property lookup, and definition retrieval.5BSD 3-Clause