mcp_vocabulary_service

# 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 1. **Build the service:** ```bash npm install npm run build ``` 2. **Test the service locally:** ```bash # 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) 1. **Start the full stack:** ```bash npm run docker:up ``` This starts: - Nginx server on port 8080 (serving example ontology files) - MCP vocabulary service (connected to nginx) 2. **Test the stack:** ```bash # Test ontology server curl http://localhost:8080/health # View example files curl http://localhost:8080/example/ ``` 3. **View logs:** ```bash npm run docker:logs ``` 4. **Stop the stack:** ```bash npm run docker:down ``` 3. **Connect to Claude Desktop:** Copy the configuration from `claude_desktop_config.json` to your Claude Desktop configuration file: - **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` Or merge with existing config: ```json { "mcpServers": { "earth616-vocab": { "command": "node", "args": ["/full/path/to/earth616_mcp_vocab_service/dist/index.js"], "env": { "NODE_ENV": "development" } } } } ``` 4. **Test in Claude Desktop:** After restarting Claude Desktop, you should be able to use these tools: - `hello_vocab` - Simple test tool - `get_ontology_info` - Basic ontology information - `test_ontology_server` - Test connectivity to the ontology file server - `list_example_files` - List available example files ## 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**: `/health` endpoint for service monitoring ## Next Steps Following the iterative approach outlined in `VOCAB_SERVICE_PLAN.md`, we'll gradually add: 1. File-based vocabulary term lookup 2. URI resolution capabilities 3. W3C PROF Profile navigation 4. Complete vocabulary dataset access 5. Cross-layer navigation tools ## Development ### Local Development - `npm run dev` - Watch mode for development - `npm run build` - Build TypeScript - `npm start` - Run the built server ### Docker Development - `npm run docker:build` - Build Docker image - `npm run docker:up` - Start full stack (detached) - `npm run docker:down` - Stop full stack - `npm run docker:logs` - View MCP service logs - `npm run docker:test` - Quick health check test ### Development Workflow 1. Make changes to `src/index.ts` 2. `npm run docker:up` to test with full stack 3. Use Claude Desktop tools to test functionality 4. `npm run docker:logs` to debug issues 5. `npm run docker:down` when done The server runs on stdio and communicates with Claude Desktop via the MCP protocol. The Docker setup simulates the full production environment locally.