@langwatch/mcp-server 0.0.1

package/.eslintrc.cjs

@@ -0,0 +1,37 @@
+/** @type {import("eslint").Linter.Config} */
+const config = {
+  parser: "@typescript-eslint/parser",
+  parserOptions: {
+    project: true,
+  },
+  plugins: ["@typescript-eslint"],
+  extends: [
+    "plugin:@typescript-eslint/recommended-type-checked",
+    "plugin:@typescript-eslint/stylistic-type-checked",
+  ],
+  rules: {
+    // These opinionated rules are enabled in stylistic-type-checked above.
+    // Feel free to reconfigure them to your own preference.
+    "@typescript-eslint/array-type": "off",
+    "@typescript-eslint/consistent-type-definitions": "off",
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/no-unsafe-assignment": "off",
+    "@typescript-eslint/ban-ts-comment": "off",
+    "@typescript-eslint/require-await": "off",
+    "@typescript-eslint/no-unsafe-member-access": "off",
+    "@typescript-eslint/no-unsafe-call": "off",
+    "@typescript-eslint/no-unsafe-argument": "off",
+    "@typescript-eslint/no-unsafe-return": "off",
+
+    "@typescript-eslint/consistent-type-imports": [
+      "warn",
+      {
+        prefer: "type-imports",
+        fixStyle: "inline-type-imports",
+      },
+    ],
+    "@typescript-eslint/no-unused-vars": ["warn", { argsIgnorePattern: "^_" }],
+  },
+};
+
+module.exports = config;

package/README.md

@@ -0,0 +1,69 @@
+# LangWatch 🏰 MCP Server
+
+The LangWatch MCP Server is a tool designed to aid finding, searching, and looking up Traces from the LangWatch platform via the [Model Context Protocol](https://modelcontextprotocol.io/introduction).
+
+This server facilitates communication with LangWatch's API, allowing you to retrieve and manage LLM traces.
+
+## Setup in Cursor 👩‍💻
+
+1. Navigate to the Cursor Settings
+2. Navigate to the MCP item in the sidebar
+3. Set the "name" as "LangWatch MCP"
+4. Set the "type" to `command`
+5. Set the "command" to `npx @langwatch/mcp-server`
+
+> [!TIP]
+> By default the environment variable `LANGWATCH_API_KEY` and `LANGWATCH_ENDPOINT` are pulled into the project. If that isn't an option for you, you can also use arguments in the command inside Cursor.
+
+- `--apiKey`: Your LangWatch API key. This is mandatory and must be provided.
+- `--endpoint`: The endpoint for the LangWatch API. Defaults to `https://app.langwatch.ai` if not specified.
+
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="../assets/mcp-server/cursor-setup.dark.webp">
+<source media="(prefers-color-scheme: light)" srcset="../assets/mcp-server/cursor-setup.light.webp">
+<img alt="LangWatch Logo" src="../assets/mcp-server/cursor-setup.light.webp" width="900">
+</picture>
+
+## Tools
+
+The MCP Server provides the following tools:
+
+### `get_latest_traces`
+
+- **Description:** Retrieves the latest LLM traces.
+- **Parameters:**
+  - `pageOffset` (optional): The page offset for pagination.
+  - `daysBackToSearch` (optional): The number of days back to search for traces. Defaults to 1.
+
+### `get_trace_by_id`
+
+- **Description:** Retrieves a specific LLM trace by its ID.
+- **Parameters:**
+  - `id`: The ID of the trace to retrieve.
+
+## Usage in Cursor
+
+To use these tools within Cursor, follow these steps:
+
+1. **Open the Cursor Chat view:**
+    - `Cmd + I`
+
+2. **Ensure the MCP server is running:**
+
+3. **Interact with your Agent:**
+    - Ask a question like the following to test the tools are accessible: *Note: When the tool is detected, you'll need to run `Run tool` in the chat view for it to be called.
+    - > "I just ran into an issue while debugging, show me the latest traces from the last 30 days"
+
+<picture>
+<source media="(prefers-color-scheme: dark)" srcset="../assets/mcp-server/cursor-example.dark.webp">
+<source media="(prefers-color-scheme: light)" srcset="../assets/mcp-server/cursor-example.light.webp">
+<img alt="LangWatch Logo" src="../assets/mcp-server/cursor-example.light.webp" width="900">
+</picture>
+
+
+## 🛟 Support
+
+If you have questions or need help, join our community:
+
+- [Discord Community](https://discord.gg/kT4PhDS2gH)
+- [Email Support](mailto:support@langwatch.ai)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }