initial commit

Author: davidfekke

.DS_Store

@@ -0,0 +1,145 @@
+# Created by https://www.toptal.com/developers/gitignore/api/node
+# Edit at https://www.toptal.com/developers/gitignore?templates=node
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+### Node Patch ###
+# Serverless Webpack directories
+.webpack/
+
+# Optional stylelint cache
+
+# SvelteKit build / generate output
+.svelte-kit
+
+# End of https://www.toptal.com/developers/gitignore/api/node
+

.gitignore

@@ -0,0 +1,13 @@
+Copyright 2025 JaxNode User Group, David Fekke
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

LICENSE

@@ -0,0 +1,27 @@
+# JaxNode June 25th MCP example code
+
+This is the sample code for the JaxNode June 2025 presentation on Model Context Protocol.
+
+This example workspace has three projects in the `apps` folder. They are as follows:
+
+* apps/avmxmcpstdio - This is a MCP server running a MCP server using STDIO
+* apps/avmxmcpserver - This is MCP server running Express so it can do HTTP Streaming
+* apps/avwxchat - This is a Next.js app using a LLM consuming the MCP Server
+
+# Installing the examples
+
+These examples require Node.js 22 or higher and PNPM since this is being run from a PNPM workspace.
+
+To install, run the following command at the root level of the workspace folder:
+
+```sh
+$ pnpm install
+```
+
+This example uses OpenAI, but you can change this to use any LLM that supports tool calling through Langchain's React and MCP plugins. The default expects an OpenAI API Key. You can get one by going to [https://platform.openai.com/](https://platform.openai.com/), and going to your settings and selecting `API Keys`.
+
+You can either add your API key to your environment variables, but you also rename the `.env.example` to `.env.local`, and setting the `OPENAI_API_KEY="<YOUR_API_KEY>"` to your API key.
+
+To run the example, simply run `pnpm run dev` at the root of the project.
+
+Copyright 2025 JaxNode

README.md

@@ -0,0 +1,7 @@
+# JaxNode MCP Example
+
+To test, use the inspector:
+
+```sh
+$ npx @modelcontextprotocol/inspector node index.js
+```

apps/.DS_Store

@@ -0,0 +1,58 @@
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// Create an MCP server
+const server = new McpServer({
+  name: "Aviation Weather",
+  description: "A server that provides aviation weather information.",
+  version: "1.0.0"
+});
+
+server.tool("get_aviation_weather",
+  "A tool to get aviation weather information in a METAR format",
+  { location: z.string().length(4).describe("The ICAO code of the airport") },
+  async ({ location }) => {
+    // Simulate a weather API call
+    const weatherApiResponse = await fetch(`https://avwx.fekke.com/metar/${location}`);
+    const weatherData = await weatherApiResponse.json();
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(weatherData[0], null, 2)
+      }]
+    };
+  }
+);
+
+server.tool("get_aviation_weather_forecast",
+  "A tool to get aviation weather forecast information in a TAR (Terminal Area Forecast) format",
+  { location: z.string().length(4).describe("The ICAO code of the airport") },
+  async ({ location }) => {
+    // Simulate a weather API call
+    const weatherApiResponse = await fetch(`https://avwx.fekke.com/taf/${location}`);
+    const weatherData = await weatherApiResponse.json();
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(weatherData[0], null, 2)
+      }]
+    };
+  }
+);
+
+// Add a dynamic greeting resource
+server.resource(
+  "greeting",
+  new ResourceTemplate("greeting://{name}", { list: undefined }),
+  async (uri, { name }) => ({
+    contents: [{
+      uri: uri.href,
+      text: `Hello, ${name}!`
+    }]
+  })
+);
+
+// Start receiving messages on stdin and sending messages on stdout
+const transport = new StdioServerTransport();
+await server.connect(transport);

apps/avmxmcpstdio/README.md

@@ -0,0 +1,43 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { ChatOpenAI } from "@langchain/openai";
+import { createReactAgent } from "@langchain/langgraph/prebuilt";
+import { loadMcpTools } from "@langchain/mcp-adapters";
+
+// Initialize the ChatOpenAI model
+const model = new ChatOpenAI({ modelName: "gpt-4.1" });
+
+// Set up the MCP client and transport
+const transport = new StdioClientTransport({
+  command: "node",
+  args: ["index.js"],
+});
+
+const client = new Client({
+  name: "aviation-weather-client",
+  version: "1.0.0",
+});
+
+try {
+  // Connect to the MCP server
+  await client.connect(transport);
+
+  // Load tools from the MCP server
+  const tools = await loadMcpTools("aviation_weather", client, {
+    throwOnLoadError: true,
+    prefixToolNameWithServerName: false,
+    additionalToolNamePrefix: "",
+  });
+
+  // Create and run the agent
+  const agent = createReactAgent({ llm: model, tools });
+  const agentResponse = await agent.invoke({
+    messages: [{ role: "user", content: "What is aviation weather for KJAX" }],
+  });
+  console.log(agentResponse);
+} catch (e) {
+  console.error(e);
+} finally {
+  // Clean up the connection
+  await client.close();
+}

apps/avmxmcpstdio/index.js

@@ -0,0 +1,21 @@
+{
+  "name": "avmxmcpstdio",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "start": "node index.js",
+    "inspector": "npx @modelcontextprotocol/inspector node index.js",
+    "langchain": "node langchain.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@langchain/langgraph": "^0.3.4",
+    "@langchain/mcp-adapters": "^0.5.2",
+    "@langchain/openai": "^0.5.15",
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "zod": "^3.25.67"
+  }
+}

apps/avmxmcpstdio/langchain.js

@@ -0,0 +1 @@
+Subproject commit eca540146f0199bde9a86d7be36804cf29bf9cc6